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Bruce Nicholls 


Quanta’s QL 2000 meeting will be the biggest event this year for the 
QL, if you are attending the show, it is a time to put faces to the names 
we read/Speak about. A report on what a Quanta/QL meeting is like is 
given by Darren Branagh in this issue. A full report from the QL 2000 
meeting, no doubt, will be in the next issue and | hope the two day 
event will be a turning point in deciding the support we give the QL for 
the future. 


Several long running projects are now nearing completion and should 
be demonstrated at the show these include the much anticipated TCP/ 
IP software to allow an ordinary QL(If there is such a thing) to interact 
easily with the outside world including email and www browsing. Jon 
Dent, who is doing the development, recently sent the first ever email 
from a black box QL to the outside world more details are given in the 
news section. The colour drivers are being used on the QXL and Q40 
and with the new QPC2 soon to be released development of software 
to exploit them is happening as detailed in this issue. One unexpected 
new development from Richard Zidlicky ts the availability of GCC (GNU 
C Compiler) for the cross compilation of programs for QDOS. This 
could make the porting of C programs from other operating systems an 
easier task. 


In this issue Norman Dunbar gives us full details of his new -shock- hor- 
ror- windows program, no this magazine isn't about to change it's name 
to Windows Today, it is just a very useful program for those of us stuck 
when we need to read some Quill documentation but are without any 
means of using a QL or 
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emulator and have aPC in) ~ 
front of us. What | will say is 
don't put the icon for the Sinclair C8000 
program in a prominent | Alternate 
Timeline 
place or you may get some | Investigation 
very strange looks. qd nit 
My thanks go out to all our | 
regular band of authors for 
this issue and hope you find 
it informative. 


Finally congratulations are 
due to Dilwyn Jones on his 
marriage together with his 
well earned rest from the 
QL. | would also like to 
thank him, on behalf of all 


QL Today readers, for the — : \ 
time he spends on QL “Hmm, it seems the civilisation died out because 


; . they had to keep re-installing their operating 
Today to make it a reality. systems. They had no Time left for any real work.” 
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First QL TCP/IP Email Sent 


Jonathan Dent has sent the very first TCP/IP 
Email from a QL system Aurora SGC with 
SuperHermes: 

Bi fee See Original Message----- 

From: jondent4@mythen.ch 

{mailto: jondent4@mythen.ch] 

Sent: Thursday, August 17, 2000 8:28 PM Subject: 
This is a test mail 

Regards 

Jonathan 


Jonathan is currently writing the documentation 
for the implementation and following is a sum- 
mary of his implementation: 

The function soqlStartup(} uses a private 
TRAP#3 driver to let the main TCP/IP job know 
that a job (user program) is about to use TCP/IP 
via the soqlLibrary. soqlStartup() passes a pointer 
to a soqlLink_t object as a parameter with the 
io.open Call, and suspends the job until the main 
TCP/IP job has completed the initialisation of the 
object. The main TCP/IP job can restart the user 
program because soq|Startup() put the job num- 
ber in the object previously. 

After this soqlStartup() does an io.close and all 
further Communication uses the soqlLink_t ob- 
ject. The rest of the soqlLibrary functions use the 
soqlLink_t object to access code in the main 
TCP/IP job and can where necessary initiate 
actions from the main TCP/IP job. An example of 
this is the local DNS resolution. Any synchro- 
nisation which is necessary can be done by the 
main TCP/IP job suspending and releasing the 
user program. 

The main TCP/IP job also deals (in the present 
version) with sending data to the Internet. Ano- 
ther job deals with receiving data. This is linked 
to the main TCP/IP job in a similar way to user 
programs. Further jobs can be linked in for future 
enhancements such as PPP and a DNS resolver. 


Congratulations go to Jonathan for making this a 
reality, 


PROGS has moved 
The new address Is 
Mechelbaan 344 
2580 Puite 
Belgium 


New telephone number will be +32 15 22 23 26, 
but not connected yet. He can always be reached 
by email (PROGS@triathion98.com) or mobile 
+32 496 250345 


Quanta News 

We are delighted to announce the reformation of 
the East Anglian sub-group of Quanta. 

It will meet on the 2nd Sunday of the month in 
central Norwich. The meetings start at 2pm and 
end at 6pm, or earlier if we prefer 

At first, while attendance is building up, the mee- 
tings will be at a house at 21 Rowington Road 
Norwich, it is hoped that meetings can move to a 
local room/hall. Rowington Road is benind the 
Grove Road shops, which is near Sainsburys on 
Queens Road. Rowington Road is also near the 
Bus station and St Stephen's Street. 

The first meeting will be Sunday the 10th of 
September 2000. 

Contact: Tarquin Mills 01603-470399 


First QL (successor) with Ethernet 


support 

Claus Graf and Richard Zidlicky report that the 
Q40 using Linux now supports some hardware 
ethernet cards directly. This allows the Q40 to be 
part of Intranets and so on. Richard and Claus 
have tested ethernet based networks with Q40, 
PC and Apple Macintosh and have been able to 
browse W3 pages, downloaded software via ftp 
and use telnet sessions, for example (Q40 as 
web-, ftp-server). All this is possible with the new 
Q40 Linux kernel 2.2.6-2. SMSQ/E driver is not 
available (yet?). 

More on the Q40 and Ethernet adapters can be 
found at http://www.q40.de 


RWAP Software - latest News 

Our apologies to anyone hoping to see us at the 
QL 2000 show (Portsmouth) - continued ill-health 
makes it highly unlikely that we will be able to 
attend. Please note that overseas customers can 
now update their software by sending the original 
disks plus 3 IRCs per program. UK users need to 
send £1 plus the original disk. 

QL Genealogist has now been updated to v3.26. 
This is to cope with one minor bug which has 
been found. However, users of this version will 
find that it is now much easier to Change the 
parents and spouse details for any given 
individual. We are looking at improving the DEX 
program - any suggestions would be appreciated. 
QL Cosmos has now been updated to v2.03 
which overcomes the fact that v2.02 did not work 
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on all SMSQ/E versions. 

One or two people have commented that QL 
Cash Trader does not work under SMSQ/E. This 
is possible under v3.7 provided that you have at 
least SMSQ/E v2.98 - this is due fo a disastrous 
bug in the SMSQ/E machine code vector conver- 
Sion routines. 

We have now released Image D [cost £10) - a 
program to allow you to create three dimensional 
views of objects, including hidden line, shading 
and wireframe techniques. Perspective and mag- 
nification can be controlled and multiple objects 
defined and positioned relative to each other 
Rich Mellor 


Web-News and Updates 


Norman Dunbar is collecting documentation on 
the inner working of QDOS and is publishing 
them on his web site: 
http://www.Dunbar.cwc.net/qdos/qdos.html 


Thierry Godfrey wrote: 

For those who didn't notice yet, some new and 

updated software is available from my Web site 

(http://qdos.cjb.net/english/download.htm)). 

1. New: 

- liomcrypt v0.1.0: a strong cypher algorithms libra- 
ry for C68. 

- fipmhash v0.8.2: hash functions library for C68. 

2. Updated 

- MicroEMACS v4.00 (08/08/00 release): better 
tags handling. 

- Clags v4.0.3a: this tags file generator now un- 
derstands S*BASIC and SSB (Structured Super 
BASIC: hi Tim ! --) 

- (pug fix}: Filelnfo ll v3.44 

My Web site is also undergoing a massive update. 


While doing the layout, more news arrived: 
Thierry Godfrey has released a new MicroEMACS 
version (13/09/00) which is available from his 
web site at http://qdos.cjb.net/download.html 
The changes are: 

- Added the vertical scroll bar. 

- There is no more screen flicker when moving 
around using the page/line up/down loose 
items. 

- Added the missing ‘arrow down’ character into 
the italic font. 

- Added the <UNDO> (or «PAUSE for QXL+ 
SMSQ/E v2.98+) key binding. 

- Changed the patch level to 06 into the “about” 
menu (| forgot to do so on 08/08/00 !}. 
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Dilwyn Jones wrote: 

| have now added an update (v3.05k) to Mark 
Knight's version of Editor 2000 onto my Web site. 
This fixes a bug which could crash some sys- 
tems due to the release of Turbo used to compile 
it, according to Mark. He has also sent me anew 
version of Heartbeat (v3.01) for inclusion on the 
same page. 

lve also added Norman Dunbar's latest minor up- 
date to Winback v2.22 which now includes a note 
concerning the use of Joinfile on SMSQ/E to 
restore and join together large files backed up 
across several floppy floppy disks. Norman's 
Black Hole device driver is also there, and the QL 
Net links page includes the link to Norman's new 
QDOS website. 

Meanwhile, Darren Branagh's QL Windows 
Screen Saver has been added. This is a Windoze 
screen saver program with a QL feel - basically, 
he has "stolen" some QL pictures from my web- 
site to make a screen saver for Windoze which 
displays pictures of Super Gold Cards, Qubides, 
QLs etc (makes my PC look much better'll). 
Beware though, it has a picture of Darren in it 
somewhere. If anyone does download this 14MB 
file, can you let me know if it works, as | had 
some, err, fun creating the self-extracting zip tile 
and I'm not sure if it works on all PCs or just mine! 


Dilwyn Jones 
dilwyn.jones@dj.softnet.co.uk 
http://www.soft.net.uk/dj/index.html 


Just Words! - Style-Check 

| have made some additions to the Style-Check 
data base. The new style_dbf file (9K} can be 
downloaded trom my web page. 
hitp://members.tripod.co.uk/geoffwicks/ 
justwords.him 

Happy checking! Geoff Wicks. 
geoffwicks@hotmail.com 


Darren Branagh reports on 
FreeDOS compatible with QPC1 


The following came about after the London 
Show, when Roy Wood actually had to lower 
himself to buying a copy of MS-DOS 6.22 | was 
Selling for a fiver on my Q-CELT Stand, as he 
needed it to install QPC for a customer! 

| thought that there must be some way of using 
QPC without Bill Gates benefitting - and there is, 
its called FreeDOS! 

It is a totally free, completely rewritten 100% com- 
patible DOS clone, that has nothing to do with 


Microsoft - you can download it at: 
www.freedos.org 

And I've tested QPC1 on it over the last 3 or 4 
days, and although still a beta 5 version, it has 
worked flawlessly - although disk access is a 
little slow... 

darrenbranagh@hotmail.com 


Richard Zidlicky 

reports that he has succeded in using gcc {a 
common unix/linux c compiler) to crosscompile 
for QDOS. He has diffs to gcc-2.951-core to 
produce a crosscompiler for qdos. It works well 
enough to compile a working version of c68. It 
uses C68 libs, as68 and linker 

For more information contact 
Richard.Zidlicky@stud.informatik.uni-erlangen.de 


TF Services 

New from TF Services is Compswitch. It is a 
4-way UK trailing socket with a 2m lead. From first 
appearances it looks like a standard extension 
socket until you look at the side. 

One socket nearest the cable is marked 
‘Computer and the other three are marked 
‘Switched’. A current taking device (computer, 
light, hifi etc) is plugged into the ‘Computer’ 
socket. The remaining 3 sockets then mimic the 
on/off state of this contro! device. ie switch on 
the ‘computer’ and the remaining devices (sound 
system, scanner monitor, modem etc) switch on, 
together with an LED. 

When the ‘computer’ switches off, then all the 
other devices switch off 

This can be used with a QL with a switch in its 
power line, assuming the wall switch is inconve- 
nient. 

It can also be used with a QL in a tower case, so 
that the main case switch acts as a master 
switch. It can also be used with current IBM ATX 
computers, which have a soft power-down. In 
this case switch-off is automatic when the com- 
puter powers down. It can also be used with 
room lights that are connected to the ring main, 
or ‘real’ hifi systems, where all components are 
separate. 

The only limitation is that the ‘computer’ must not 
take more than 500 watts, and total switched 
capacity must not exceed 100 watts. 

It is not suitable for computers than have a low 
current consumption - ie laptops. 

Cost is £24 inclusive. 


New Game 
Jerome Grimbert was busy again. He writes: 
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| now have a Q*Bert game in high colour for my 
Q40 in 1024x512 {it should also work with GD2 
256 colours), but this is not tested). 

Available at: http://grimbert.cjb.net/ 

lt is about 40K zip (give you a 600 K program) 
The text file is an old one made for mode 8. 


Domains for sale 
Ludovico Camarda has the following domains for 
sale: 

Sinclair QL.com 

SinclairQL.net 

SinclairQL.org 
The relative “under construction” pages are al- 
ready on line. Feel free to make an offer if you are 
interested. 
You can reach Ludovico via email: 
Icamarda@esoc.esa.de 


Editor: We suggest that, before you make an offer, 
you better make sure that the Name SinclairQL is 
free from any copyrights - so that you don't end 
up in a situation where you paid for the domain 
and are forced by the copyright holder to return 
the domain to him. These things have happened 
several times in the past. It is fairly unlikely that 
any ‘Sinclair’ or “QL” copyright holder would 
complain, but the possibility exists. 


More MicroEmacs 

Just 12 hours before QL Today will be going to 
the printer Thierry informed us about even more 
changes to MicroEmacs. There are too many 
details to list in the remaining two lines but if 
youtakee a look at his website, you'll quickly find 
out what's new. 


Helpline 

Q. | have a Falkenburg hard disk system on my 
tower cased QL system. When | try to DELETE a 
file, it tells me it deleted the file OK, in fact DIR 
WINi_ seems to imply it has been deleted, but 
the next time | switch on the QL, it says the file is 
still there. What is wrong with the system? 

A. These hard disk systems have a WIN_FLUSH 
command to force file operations to be written 
out to disk. What is happening is that the file is 
being deleted from the slave blocks in memory 
but the changes not written back to the hard 
disk immediately. If you issue a WIN_FLUSH 
command before switching off or resetting the 
QL this will force the deletion to be written to the 
hard disk itself and fix the problem. 
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Trader travel experiences 


Tony Firshman 


Croatian QL Show - 
epilogue 


You may remember the Croa- 
tian QL show almost two years 
ago now. You almost certainly 
though will not have participa- 
ted, because it was in a very 
small room, so we had to turn 
away most of the 500 visitors 
(grin). 

On the way Roy Wood, driving 
my car had a horrific accident 
on black ice in Belgium. My in- 
surance company refused to 
pay out as they said the follow- 
ing clauses actually said no- 
one except me could drive my 
Car on business: 

Entitled to drive: Policyholder 
and any other persons with 
policyholders permission 
Limitations as to use: Policy- 
holder on personal business 
(and other non relevant legal 
jargon). 

Does no-one except me hate 
that ‘persons’ word - what is 
wrong with ‘people’? 

| had asked my broker for any 
drivers as | need to share driv- 
ing when going to shows on 
business. Bishopsgate Insu- 
rance (now Fortis) said that this 
actually meant only | was al- 
lowed to drive my car on busi- 
ness. My wife Sarah has 
exactly the same clause and 
She read it that she was in- 
sured for other drivers on busi- 
ness. 

suspect any person who uses 
their own Car on company bust 
ness has a similar clause. 

Well Bishopsgate refused to 
pay. | had to pay the costs of 
the claim, approaching £2000. | 
was extremely lucky that we 
nad not ploughed into an army 
of holiday makers. 

We hit the crash barrier at 
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about 65mph, and then got hit 
broadside by a 40 ton trailer 
truck going at speed. Such Is 
the strength of my car that we 
then did a 2000 mile round trip 
without further incident. (Well 
other than Roy destroying a 
wheel rim in a 1 mph broadside 
into the kerb). 

| repaired the car myself, and 
saved a great deal of money 
by stripping it and re-assemb- 
ling. | also got a complete door/ 
mirror for £90, saving about 
£400 on the new prices. | used 
an amazing scrap yard in 
Aylesbury. | really enjoy moun- 
taneering over piles of rusty 
heaps - it is amazing what you 
find. However this ‘scrap yard’ 
is a glossy parts shop with bar 
codes, computers, free base- 
ball caps and coin-in-the-slot 
coffee! Now only 10 year old 
Volvos just don't happen in 
scrap yards. The newest | could 
find elsewhere in my model 
range was 16 years old - only 1 
year after they introduced the 
model. However you can but 
try. In a weak voice, | stammer 
"You dont happen to have a 
nearside door and electric 
wing mirror for a 1990 Volvo 
740 GLE do you’? "What 
colour’ was the reply, after a 
millisecond of typing into the 
terminal. Drat, they don't have 
my colour They sold me an 
identical door from a 12 year 
old Volvo in perfect condition. It 
seemed churlish to complain 
that it was blue and had no 
heated mirror Things were 
looking up. 

With the third party cost - a 
lorry with severe bodywork 
damage - | had to fork out over 
£1500, and | still hadn't replaced 
the wheel rim and the da- 
maged tailgate trim. 

| then took Bishopsgate to our 


insurance ombudsman. Now, as 
you all know, it is a well known 
fact of life that the individual 
stands no chance against the 
might of the insurance compa- 
nies. Well that was the case in 
‘Life before Superombudsman’. 
After only 18 months of delibe- 
ration, they found in my favour 
plus interest. They said, that 
they knew what the certificate 
meant to underwriters, and that 
it waS very common on cer- 
tificates. However they under- 
stood how | did not realise that 
‘use’ meant ‘driving’. | conten- 
ded | was ‘using’ the car and 
Roy was ‘driving’. Bishopsgate 
make a great play of how their 
policy documents have won 
Plain English Awards. However 
the only mention of business is 
on the certificate of insurance - 
the document drawn up by 
lawyers. 

My victory will mean that the 
insurance industry in the UK will 
have to change their certifi- 
cates, and will mean many 
people can make retrospective 
claims. 

It is good to have such a posi- 
tive result after going all the 
way to Croatia and back 
through the worst December 
weather for 50 years to sell 
one keyboard membrane, and 
lose most of my stock in the 
Belgium ice. 

Bishopsgate though got a final 
stab in the back. They have 
only paid half the cost of the 
wheel rim and tailgate tirm 
(£200) and refuse to compen- 
sate me for the £700 | saved 
them by getting the door and 
preparing/re-fitting the car. 
Watch for developments in the 


QL Shows 

The few traders left in the QL 
scene make quite an effort to 
get to shows, and often orga- 
nise them. 

By the time you read this, Roy 
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Wood and | will have flown to 
ltay for the Reggio Emilia show, 
and Jochen will have driven 
from Germany. 

All the European shows/work- 
shops we attend are free, and 
we also direct mail people on 
our database. 

It is pretty depressing how few 
of you though take the trouble 
to come. We really enjoy the 
shows, and it is always a good 
get together We often eat 
afterwards at a local restaurant. 


We have even been known to 
visit bars occasionally - only to 
be sociable | hasten to add. 
The QL more than any other 
computer | have known, past 
and present, is a very sociable 
machine. Most people we meet 
are very attached to their ma- 
chines, especially those with 
the original black job. 

However if attendances at the 
shows drop any more, then 
they will cease to happen. We 
know there are a number of 


people who have never atten- 
ded a show. If you have never 
been to one in the past, then 
you must make a special effort 
for the QL 2000 bash at Ports- 
mouth in October. it looks like 
being a very well attended 
show, and there are even more 
than 16 people flying in espe- 
cially from the USA. If they can 
do it, then there is no excuse 
for anyone in Europe. 


Q40 Colour Etc, 


by George Gwilt 


Introduction 

Over the years there have been various changes 
in QL hardware and software. Probably the intro- 
duction of Toolkit ll was the earliest and most 
widespread advance, since it was effectively a 
necessary correction and upgrade to the original 
QL Roms. ! would guess that the advent of exten- 
ded colour to the QL scene will be more perva- 
sive than many of the other changes. It is already 
in use in Aurora, by means of a version of 
SMSQ/E. Now it is available in the Q40, again with 
SMSQ/E and will soon be released for the QXL 
and QPC. | trust that this exploration of colour will 
be of interest to some. 

What follows is based on my experience with 
SMSQ/E v2.97 on my Q40. 


Colour 

The recent advance in SMSQ/E, with which | am 
concerned here, is the extension in range of 
colours from the maximum of eight on a basic QL 
to 65536. 

What | want to do here is show how this affects 
the owner of a Q40. 

Actually, if the owner simply switches on his Q40 
and does nothing to alter the display, the exten- 
ded colours do not affect him in the least. Four 
colours (Mode 4) and eight colours (Mode 8) are 
available just as before. All programs run as nor- 
mal. However, as soon as the display is changed 
all eight colours become available even though 
the machine appears to be in Mode 4. Indeed you 
cannot now change mode which remains at °33" 
instead of "0" for Mode 4 or 8" for Mode 8. To get 
the look of the old Mode 8 you would have to set 
the appropriate csize. But why do that? The eight 
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colours are already there, and we don't need big- 
ger pixels to hold the extra colours so the larger 
csize is unnecessary. 

There is one peculiar effect many must have 
noticed. For example in Perfection the borders 
look odd. This is because the stipple colour re- 
quested by the programmer of Perfection was a 
mixture of white and blue with a stipple number 2. 
In an ordinary QL Mode 4, blue is the same as 
black, so the border is seen as a mixture of white 
and black. With the extended colours you see a 
mixture of white and blue instead. This effect is 
true of several other programs, but on the whole 
these changes, though possibly slightly upsetting, 
are benign. However in version A.04 of QD {(cor- 
rected in v A.07) a defined block became illegible! 


To Stipple or not to Stipple 

Colour is very useful in the legible presentation of 
written material to the users of programs. A 
reader can easily focus upon a particular set of 
items if they are in a distinctive colour The more 
different colours there are, the greater the num- 
ber of categories that can be highlighted. Thus it 
has always been a bit frustrating that the legible 
non stipple colour combinations of paper and ink 
are so few. For example green and white do not 
combine well. The best use of that combination is 
probably for "unavailable" menu items. The original 
QL offered stippling as a way of increasing the 
apparent numbers of colours available. But stip- 
pled ink is almost bound to fail, and there are per- 
haps only half a dozen combinations of stippled 
ink and paper which are acceptable. 

This is where the extended colour system can 
really help. Each colour is solid, so that, provided 
there is enough contrast between two colours, 
they can satisfactorily be used as paper and ink. 
Of course you can use stipples as well for both 
paper and ink, which gives you more than 5*10°19 
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different combinations to choose from. The exact numbers available are shown below 


Table Showing Number of Combinations Available 


No of colours Solid pairs Solid/Stippled pairs 
4 6 561 

8 28 10,878 

256 32,896 13, 358,850,040 

65,536 214,750, 880 57,645,019, 790, 762,354,688 


(It is left as an exercise to find the number of com- 
binations if all 2°24 colours are available. [They 
are not available on the Q40!) 


The leap from 4 or 8 basic colours to 65536 is 
really rather daunting, so how should one make 
practical use of this? 


The first thing to look at is how these extended 
colours can be obtained via SBASIC. 


Extra Modes 
To replace the Mode instruction there are four 
new Basic commands 


COLOUR_QL 


- Sets the “normal” QL 8 colours 


COLOUR_PAL 
- Sets a palette of 256 colours 
COLOUR_NATIVE 
- Allows the full range of 65536 colours 
COLOUR_24 
- As _NATIVE but with different parameters 


The palette consists of 256 colours chosen from 
the total 65536 available. These can be reset 
from the default range if wanted. The default 
range comes with the first 64 colours described 
in words. For example extra greens available are 
called Light Green, Dark Green, Lime Green, 
Apple Green, Pastel Green, Dull Green, Dusky 
Green, Grass Green and Sea Green. The remain- 
der of the 256 colours in the palette are not 
named. The implication seems to be that 64 dif- 
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ferent colours is probably enough choice for the 
paper, ink and borders which form most of the 
colour needs of programs. 


lf COLOUR_QL is set, the colour numbers are as 
in the QL Manual, 0 = Black, 1 = Blue, 2 = Red and 
SO on. Stipples can be defined either by a single 
composite number, or by two numbers giving the 
two colours with stipple 3 assumed, or by three 
numbers the last being the explicit stipple. 


For COLOUR_PAL, on the other hand, a colour is 
given as a number from 0 to 255. A stipple requi- 
res the two colours to be given explicitly, though 
the stipple number itself need not be given if 3 is 
intended. Oddly, the first eight default colours, 
although they are the familiar Black, White, Red, 
Green, Blue, Magenta, Yellow and Cyan, are given 
numbers 0 to 7, which do not correspond with the 
QL numbers, except for Black, Red and Yellow! 


COLOUR_NATIVE requires colour numbers from 0 
to 65535 (which is 2°16 - 1) and this accesses the 
full range of colours available on the Q40. 


COLOUR_24 accesses the same range as does 
COLOUR_NATIVE, but the colour numbers run 
from 0 to 16777215 (which is 2°24 - 1). 


All the COLOUR. modes except COLOUR_PAL 
have parameters which directly describe the 
colour in a simple way. That is, they each indicate 
how intense the contribution is from the three 
primary sources, Red, Green and Blue. In the case 
of COLOUR_QL, the intensity of each is either 
minimum (ie not present) or maximum. For the 
extended colours the hardware allows a range of 
up to 64 intensities. This is achieved by allocating 
five bits of a word to each of the three primary 
colours while leaving the least significant bit of 
the word to be the common least significant bit of 
a Six-bit intensity. 

The most significant five bits are assigned to 
Green, the next five to Red and the next again to 
Blue as shown below. Since equal intensities of 
the three colours produces white, the least 
significant bit is labelled "WO". 

This means that in practice the number of shades, 
except for White, is limited to 32. 


| G5 G4 G3 G2 G1 R5 R4 R3 R2 R1 BS B4 B3 B2 Bi WO | 


The colour parameters when COLOUR_NATIVE is 
set are the word representations of the bits as 
described above. 
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The long word needed to define the colour for 
COLOUR_24 has a zero mosi significant byte, 
followed by bytes for each of Red, Green and 
Blue. This appears to allow for a range of 256 
intensities for each colour but, as stated above, 
only five bits are available for each of the three 
colours, so only the value of the top five bits of 
each byte ts transferred to the appropriate colour 
What of the least significant bit? The White bit? 
Ah, what indeed! There is presumably a logic to it 
but it seems as if this bit is more or less arbitrarily 
set. SFFFFF8 and $FDFFF8 set it, S$FFF8F8 and 
$FDF8F8 don't. The moral is - if you want to set 
the bits precisely, use COLOUR_NATIVE. This wil 
give you full control. 


Practical Use 

For applications using text, there is no need to 
access the full range of colours. COLOUR_PAL is 
probably more than enough to allow pretty bor- 
ders and paper colours as well as ample variation 
of ink colours. 

However, for graphical work, the extended co- 
lours can indeed be useful. For example, the fol- 
lowing will enable you to see displayed the range 
of shades of Magenta. 


100 COLOUR_NATIVE 

110 OPEN#3,SCR_624X420A0X0: PAPER#3, $ABCD 

120 BORDER#3,4,$F00, $49F,1:CLS#3 

130 FOR x=0 to 31:BLOCK#3, 6, 300,x*6+200, 60, $42*x 


Screen Background 

One other enhancement which is part of the ex- 
tended colour system is to allow a background. 
You can set this background, which will show up 
between any windows on the screen, either to a 
colour (possibly stippled) or to a screen image 
previously saved. 

The SBASIC commands are 


BGCOLOUR_QL 
for the 8 QL colours 
BGCOLOUR_24 
to access the extended colours 
BGIMAGE «scr_image> 
to set a screen image 


These, and all the previous SBASIC commands, 
are also available as Operating System calls. This 
means that the extended colours can be used by 
assembly language programs as well as by 
SBASIC. 


QL Today 


Sprites, Blobs and Patterns 
One place where the extended colours might be 
interesting indeed is in the definition of sprites and 
patterns. The explanation of how to define sprites 
using the extended colours is given in the de- 
scription of the Graphic Device Interface Version 
2. Unfortunately this does not enable a program- 
mer to use the system, owing to something faulty 
having crept in, either in the description itself, or in 
SMSQ/E v2.97. 
"As a result | cannot comment more on this 
interesting and enticing aspect.” 
That is what | wrote before | learnt that the soft- 
ware did actually support extended colour 
sprites. As a result | pried deeper into the 
SMSQ/E software and found that there was one 
crucial mistake in the description. In case others 
may have been equally puzzled, I'll expose this 
mistake. 
Sprites have a header defining the screen mode, 
size and origin of the sprite. The first word for an 
ordinary QL sprite is either $0100 for Mode 4, or 
$0101 for Mode 8. This has been extended to: 
$0210 for 256 real colour (GRBGRBGX) where 
X=R/B 
$021F for 256 palette colour 
$0221 for Native colour 


In the description issued with the Q40 the first 
word of the header was wrongly described as 
having a first byte of "0" or “1”, instead of "1" or °2". 
For sprites, the definition contains pointers to a 
“colour pattern’ and a “pattern mask”. For the 256 
colour modes, the pattern and mask consist of 
one byte for each pixel. For the Native colour one 
word is needed for each pixel. 


Odd Quirks 

Sometimes | have loaded several programs be- 
fore | make the extended colours available (eg by 
DISP_SIZE O for the 512x256 screen, or by 
DISP_SIZE 1024, for the 1024x512 screen). 
Clearly the channel blocks for all screen channels 
have to be amended. At the least they will now 
contain the new address of the screen. This will 
be $FE800000 and not $20000. One might hope 
that the colours would have been adjusted too. 
However, it appears that the contents of the 
colour masks, which must now contain the 
NATIVE code for colours of paper etc, are left 
unchanged. This seems to account for the fact 
that the ink in channel 0 of a previously opened 
SBASIC appears yellow, having the code $FFOO, 
instead of green, whose code is, or should be, 
$F 800. It is a slightly less odd fact that if you set 
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the colour 4 (green) under COLOUR_QL, you will 
get SF100. If you set colour 3 (the default green) 
under COLOUR_PAL, you get the correct colour 
$F 800. If you look very closely you can detect a 
difference in these two greens. 


Two more SBASIC commands are available which 
can, to some extent help here. They are 
PALETTE_QL and PALETTE_8. These enable 
you to set the 8 QL colours and the 256 palette 
colours. The colour numbers used here as para- 
meters to define the colours wanted are those 
applicable to COLOUR_24, or "true colours’ as 
they are called. I'm afraid however that if you do 
use PALETTE_QL to alter green from $F100 to 
$F 800 (which is the default value in the palette) 
you will be slightly disappointed. This is because 
the least significant White bit is now set, so that 
you get $F801 for your pains. This extra 1 
appears aiso in Cyan, Yellow and White. The 
practical significance of all this is small, so 
perhaps we can forget it. 


Technical Information 

One of the programs originally supplied with the 
Q40 is NET_PEEK. Amongst other things this 
aims to describe the colours used in any screen 
or console channel. The only colours recognised 
were the 8 QL colours, most, if not all, the others 
being returned as Black. That has been corrected 
and a new version of NET_PEEK wil give in 
words all the colours named as the first 64 of the 
palette. Any other colour is shown as the hex 
NATIVE colour number In order to reprogram 
NET_PEEK, | had to investigate the new. contents 
of a SCR/CON channel block. What ! found was 
this. 

lf the Mode has been altered to 33, that is, if the 
extended colours are available, the position in the 
channel block normally used for the colour mask 
for paper, strip and ink contains instead the colour 
numbers for the main and contrast colours (both 
the same if there is no stipple). The stipple 
number is in the usual place, that is in the most 
significant two bits of the colour byte for paper 
strip, ink and border If the mode COLOUR_QL is 
being used the colours are mirrored in the usual 
colour bytes, but if any other mode is in use, the 
colour byte is 

$00 for no stipple 

$20 for stipple 0 

$60 for stipple 1 

$A0 for stipple 2, and 

$E0 for stipple 3. 


SS 


Anyone following all this carefully might have 
wondered where the border colours go because 
there is no “colour mask" for the border in the 
normal QDOS system. What happens is that one 
word (but not two!) has been found for the border 
colour It is the last word in the extension to the 
channel block required by the Pointer Environ 
ment. It is thus at word $42 from the start of the 
channel block, or at -2 from the address of AO if 
you are using EXTOP to access the channel 
information. If there is only one colour, its number 
is Stored in that word. If there are two, the number 
of the first colour is abridged and placed in the 
most significant byte and the number of the 
second colour is similarly abridged and placed in 
the least significant byte. 

The abridgement is done by taking the three 
most significant bits of the red contribution, 
followed by the three most significant bits of the 
green contribution and finally the two most 
significant bits of the blue contribution. 

You can see all this for yourself by using 
NET_PEEK. First, find the channel number by 
using menu item 5 (Channels) to display the 
channels. The number under the heading SYS is 
the internal channel number By using that as the 
parameter for menu item 6 (Single Channel) you 
will see displayed information about that channel. 
lf it is a Screen or console channel you will see 
the colours of paper etc. You will see at the top 
the address (in hex) of the channel block itself. By 
using menu item 7 (Display RAM) with the ad- 
dress of the channel you can now see the con- 
tents of the channel block. 


Etc. 

An advance associated with the new screen dis- 
play is the increase in the size of window avai- 
lable. For some time now, with Aurora and the 
QXL sizes from 800 by 600 upwards can be set. 
(So far | have only been able to set sizes 
1024x512 and 512x256 on my Q40, but perhaps 
that will change in future.) 

The greater screen sizes have proved popular 
enough for programs to be altered to take ad- 
vantage of them. This should be comparatively 
easy, since all that need be done is to increase 
the dimensions of any bigger window, if neces- 
sary altering also its origin. 

A similarly simple, or even simpler, alteration could 
allow existing programs to take advantage of the 
extended colours. In the unlikely event of that not 
being done, it will be left to each user to devise 
his own colourful programs. It would be a pity if 
that were the only use of this advance. 
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Indeed this is part of the general question of how 
improvements’ can best be made use of 


Using "Improvements" 


MINERVA 
One such improvement Is the tokenisation of inte- 
gers in Minerva. This can speed up SuperBASIC 
programs by storing integers either as bytes or 
as word long numbers internally. As far as | can 
see this is hidden from the user but will apply to 
any SuperBASIC program run. To allow such pro- 
grams to be compiled by Turbo you are told to 
turn off this tokenisation. Under the new version 
of Turbo this will no longer be necessary. This 
Should enable that particular advance to become 
more generally useful. 
However another change in Minerva, which has 
also been adopted by SMSQ, is an increase in the 
number of arithmetic operations available via the 
vectored routines in the operationg system. 
Obviously these can be, and presumably are, 
used by the operating system itself, but cannot be 
part of an external program written to be usable 
on all QL type machines, unless this program is 
machine specific or contains code determining its 
host machine and corresponding specific code 
depending on that machine. 
As | Said earlier | guess that there will be sufficient 
interest in the colour capabilities of SMSQ/E for 
programs using them to appear | wonder if too 
we shouldn't take advantage of the more 
widespread distribution of machines based on a 
68020+. It may have been the remark in the 
Manual for the Super Gold Card 

". We recommend that your programs do not 
make use of special 68020 instructions so that 
they run on all QL systems. This is a particularly 
important consideration for any program des- 
tined for sale or publication.” 
that caused me to do the opposite and to 
produce my assembler, GWASS, using many, if not 
all, of these special instructions. Admittedly 
GWASS was started primarily for my own use and 
later developed so that | could use the Floating 
Point Unit on my QXL and not for general 
distribution. But it is now part of the set of 
programs attached to the Q40. This shows that 
there are already in distribution programs depend- 
ing on higher machines than the old 68000/8. 
Also available to Q40 users is my program 
GWDISS, a disassembler and NET_PEEK, already 
mentioned here. The first two protest on being 
loaded into a machine which is not 68020+. The 
last works perfectly well on such a machine, but 
refuses to disassemble, thus showing _ that 
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programs can be written to check what machine 
they are running on and take appropriate action. 


Although it is not quite the same thing | should 
point out that there are now two versions of 
Turbo Toolkit, one for ordinary QLs and the other 
for SMSQ. This shows that machine specific items 
now exist. 


| suggest that the time has come to consider 
upgrading and writing other programs in a similar 
way. 


Both methods to start with: 
Dil contains the number to be set in FP format 


68020+ 

| will end by giving an example of the way that the 
68020+ CPUs could be used inside toolkits and 
programs. This concerns the ubiquitous need to 
set a number to floating point format. This is 
required for example when a number up to 2 32 
has to be returned to a machine function added 
to SuperBASIC. An example of such a function is 
FLEN. This returns the length of a file as a floating 
point number. Internally, this number will be a long 
word. As an example of the enhancement pos- 
sible in converting a long integer answer to 
QDOS floating point format | give the following 
method used in the DIY Toolkit along with the 
way it could be done using 68020+ instructions. 


This might set a zero mantissa. . 


. yes. D5 contains the mantissa -> 
Adjust the exponent for a doubling of D1 


MOVE.W D1,D4 This sets a zero exponent 
MOVE.L D1,D5 

BEQ DONE . yes it did -> 

MOVE. W #$81F,D4 OFFSET 

ADD.L D1,D1 Have we finished? . . 

BVS DONE 

SUBQ.W #1,D4 

MOVE.L D1,D5 


At this point the methods diverge 


Get ready to find the answer 


Can it be shifted DO bits up? . 


The shift worked - adjust exponent 


DIY Toolkit 
MOVEQ #16,D0 Set the maximum shift 
a 
3 The Loop 
Q 
Li MOVE.L D5,D1 Di is the working register 
ASL.L DO,D1 
BVS L2 . . no 
SUB. W DO,D4 
MOVE.L D1,D5 Reset the mantissa 
L2 ASR.W #1,D0 Try 8, 4, 2, 1 shifts 
BNE Ll If DO » 0, more to do 
DONE 


The answer |s now in D4W (the exponent) and D5.L (the mantissa) 


68020: method 


BPL Ji 
NEG. L DL 

Ji BEFFO Distt 3h) Dt 
SUBQ.W #1,D1 
LSL.L D1,D5 
SUB.W D1,D4 


As for the DIY Toolkit, the answer is in DAW/D5.L 


Make Di positive 
Set Di to the. . 
. Shift needed 
Shift the mantissa. . 
. and adjust the exponent 


NOTE: BFFFO finds the ist non-zero bit in D1 from bit 30 to bit 0 
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The DIY method requires five journeys round the 
loop Li to the end, whereas the 68020+ method 
requires no loop so is shorter and about 4 to 5 
times faster 

Given that this is a very common set of code 
which is executed many many times in normal 
programs using machine code functions, it looks 
like a good way to speed up many programs 
running on on Super Gold Cards, QXLs, Q40s and 
any other system which uses a 68020+. 


Before | finish, | would like to report that | tied my 
NET_PEEK with QPC. The results were indeed 
interesting. First of all, the registers displayed for a 
job are just what you would expect on a QL. Also 
the content of the system variables at $28000 
was correct. However, when | tried to disassem- 
ble code, the program fell over | think that was 
due to two things. 

1.1 suspect that only 68000/8 instructions were 


2. The instruction 

MOVEM.L  A7,-(A7) 

CMPA.L (A7) ,A7 
set the ZERO flag, thus signalling that the 
machine was a 68020+. 
These instructions do not set the ZERO flag ona 
68000/8. 
Clearly these are inconsistent and | think that 
either the QPC should emulate the full 68020+ set 
of instructions, or a second best, it should emulate 
a 68000/8 correctly and set off the ZERO flag. 


Conclusion 

| hope that this excursion into colour is useful. | 
hope also that we will see programs appearing 
that make use not only of the colour capabilities 
but also of the 68020+ range, maybe even of the 
Q40's FPU. 


Who knows! 


emulated, and 


QPC2 or QPC2? 


What can the future of the QL be called 


Peta Jager 


This question may seem silly at 
first but at present it is the only 
answer to the question - What 
can the future of the QL 
community be called? 

The Q40 is a beautiful thing 
and | admire the enthusiasm 
which people find for the de- 
velopment. | have furthermore 
great respect appreciating To- 
ny Tebbys work in the fulfilment 
of a real QL successor | am 
however really disappointed 
about the lack of far-sighted- 
ness of Tony Tebby with regard 
to a real QL platform in soft- 
ware or hardware. It is a slap in 
the face of those people who 
supported the QL all these 
years, who bought new hard- 
ware (QXL) and software, who 
believed in the promise of what 
was still to come (colour driver 
disk access in the background 
etc} and who see that the 
colour drivers are developed 
for the Q40 first and second to 
QXL and QPC. Even though the 
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programming is slightly easier 
for Q40, it isn't correct to treat 
those QXL users who have 
been waiting for years for the 
completion of the drivers. After 
all many people have bought 
the QXL for alot of money and 
many have then payed for 
SMSQE once again. In addition, 
the colour drivers were already 
demonstrated for the QXL at a 
French meeting years ago, ad- 
mittedly not with great success 
(they ran only on lony’s compu- 
ter}. That QPC (2) then com- 
pletely unnoticed at last gets 
the drivers, that is not nice for 
Marcel Kilgus (the programmer) 
nor for the QPC users. 

In my opinion QPC is the only 
true alternative to the QL and 
in the following paragraphs | 
give my reasons why. 

Microsoft's operating systems 
unfortunately have spread eve- 
rywhere on this planet (presu- 
mably they spread everywhere 
else). We couldn't do anything 


about that. Several things are 
important for an operating 
system to survive, if we do not 
want it to disappear like OS/2, 
Atari and Amiga os or other 
operating systems such as our 
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. software downward compa- 
tibility 

broad availability (should run 
everywhere, notebook com- 
puter, PDAS etc} 

it should run parallel to other 
operating systems. 

all available and future avai- 
lable hardware should be 
supported. 

it shouldn't be expensive. 
speed which makes work 
pleasant. 

. modern and simple to use 
software. 

All these things which | find im- 
portant are only fulfilled by 
QPC(2). 

1 - Q40 as the only available 
QL alternative (not emulated) 
offers little more compatibility 
than QPC2, it’s actually even 
less at the moment. This is at 
least what | have heard be- 
cause | dont have any Q40. 
The compatibility has more to 
do with the operating system 
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than with the platform. All pro- 
grams, which run under QDOS 
also run under QPC (partly with 
tricks}. | have forced even old 
digital Precision programs to 
run under QPC. But as | have 
said before the compatibility 
has more to do with the ope- 
rating system than the emulator 
or the hardware platform. The 
printer port under QPC is work- 
ing correctly, the serial interfa- 
ces work upto 115k baud with- 
out recognisable problems 
(tested among others in the 
mailbox environment). Disc ac- 
cess works with DOS and 
QDOS diskettes, though not 
with ED diskettes which are 
formatted with 3.2 MB as it is 
possible for Goldcard systems. 
Till now, disk access over the 
QXL-WIN file has never had 
problems. The DOS DEVICE is 
still in the proof-testing, it will be 
available soon and might be a 
small revolution since it will 
finally be possible to transfer 
data between DOS and the 
QXL_WIN file directly. Unfortu- 
nately the network in the clas- 
sic form does not work but 
QPC can use the DOS/Win- 
dows network. If two DOS 
computers are connected with 
standard PC network cards, 
then QPC can access the se- 
cond PC and it has the fastest 
QL network available which is 
only dependent on the perfor- 
mance of the installed PC hard- 
ware! 

9 - The availability of Q40 is, 
as with every proprietary hard- 
ware, naturally very bad. Even 
for such unusual operating sys- 
tems like eg. Apples MacOS, 
there are PC emulators to use 
in notebook computers etc... 
QPC2 runs practically on every 
hardware configuration with 
processors from AMD), Intel and 
also Cyrix with at least 166 
MHz. It runs on notebook com- 
puters, desktop systems and 
within emulators. One can “take 
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along” QPC, everywhere to. 


3 - Q40 only runs parallel to 
Windows if you have a second 
PC right next to it. Not incredi- 
bly exciting and a very expen- 
sive variant! QPC runs under 
MSDOS, Windows 3.1, Win- 
dows 9x/NT1/2000 at the mo- 
ment only in the full window 
mode, but the frame mode will 
be available shorily. 

4 - This is nearly impossible 
due to the Q40 design. Only 
parallel and serial devices can 
be attached right now. Using 
QPC there is not much more to 
be connected right now, but 
this will change very soon, as | 
will explain now. In the foresee- 
able future an absolute hard- 
ware availability will be possible 
for QPC (2), since all of today’s 
PCs are equipped with USB 
ports, for which you can buy 
practically any peripheral. If 
QPC supports the USB port in 
the future then no one has to 
write drivers for the actual 
hardware anymore because 
the SMSQE driver for the USB 
port suffices to operate all 
current hardware. 


5 - Well, they are not cheap 
but if you consider the few in- 
Stalled SMSQ systems available 
then the price for QPC or Q40 
is ok. Though | would recom- 
mend QPC if you already have 
a pc at home. 

6 - It is said the Q40 is very 
fast and this is clearly correct 
because a 68040 is very fast. 
But QPC2 is also fast. At the 
moment practically no PCs are 
offered under 400 MHz clock 
frequency and that is why QPC 
is almost as fast as a standard 
QXL (68040 inside). PCs now 
available have clock frequen- 
cies of 1000MHz and more, 
using these QPC(2) will then 
outperform the Q40. Even an 
available Q60 in the future can't 
be much faster it will be also 
much more expensive than 


QPC especially as QPC can 
use current hardware (UDMA 
fixed disks, AGP graphics 
cards etc). Marcel Kilgus is 
working on several projects 
which will increase the speed 
of QPC soon. The new emula- 
tion core may well bring a 20% 
or more performance increase. 
The transfer of the SMSQ/E 
floating point-routines to the 
floating point core of the PC 
CPU will bring a speed in- 
crease of about 400%. All 
these things will be put in 
concrete terms very soon. 


7 - The greatest flaw in the 
QL scene is the absence of 
software. There is practically 
nothing. There are no tools for 
programming, especially since 
many programmers have gone 
to the PC side. OK youd Say, 
we have QSPREAD, we have 
QD, Linedesign, SUQCESS, 
even some of Digital Precision 
progs will get used once in a 
while, but to be honest people, 
Qspread is a program only a 
few people use, even by the 
people who bought it (me for 
example). QD is despite all im- 
provements only an editor, no 
word processing program |s in 
sight even though that is a 
program which we are missing 
in the QL scene. There is a 
group of people who will now 
suggest: we have Paragraph, 
text87 and Quill but to be 
honest, all these programs do 
not even have all the possi- 
bilities which Wordpad offers in 
Windows 9x! Moreover you get 
this little program for free. Is 
there a good graphics program 
(Linedesign is a good program 
but since there is virtually no 
support and lack of speed, | 
don't use it much these days 
which supports actual printers? 
Only Jonathan Hudson has 
brought the QL up to date in 
the data transmission area. Yet 
we have put ourselves into the 
offside even more, if we do not 
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get internet connection to the 
rest of the world soon. The 
programs for e-mail and brow- 
sing are already available but 
instead of programming some- 
thing easy like internet connec- 
tion, the programmers waste 
here strength in customisation 
for new hardware, which will 
not be up-to-date in a couple of 
years (months). The QXL has 
shown us that we can not keep 
up with the speed the hard- 
ware develops nowadays. QPC 
does the right thing in saying: 
"Hey, why hardware, the PC is 
efficient enough. Let us con- 
centrate on software and deve- 
lop programs, which compete 
with PC programs’. Who like 
me has to work with PC hard- 
ware and software everyday 
professionally and can sing a 
song of how badly programs 
are written and how unreliably 
PC-software is (QPC excep- 
ted). QPC could close a gap 


there. With SuperBASIC, C or 
machine code we could deve- 
lop programs in a shorter time 
which can do everything one 
really needs and are also 
Stable. If QPC runs in a window, 
one could develop programs 
which run in parallel on the win- 
dows desktop or Apple desk- 
top in the PC emulation. The 
possibilities are then unlimited 
and our well-loved operating 
system could perhaps establish 
itself again and not die out. The 
Q40 however is a niche pro- 
duct with lower future pro- 
spects. E.g. The problem is, the 
QXL fans know all to well, is if 
the developers have no more 
desire to develop the Q40 any 
further (e.g. because the sales 
figures are declining) then it is 
over for all of them if they need 
spare parts which they can't 
buy anymore. A PCI graphics 
card that is needed for the 
milan is hard to get nowadays 


Jochen’s Comments 


Peta’s article forces me_ to 
reply. Others should reply too, 
but the lack of time (we're 2 
weeks behind schedule) does 
not allow other replies for this 
issue. Maybe we find some- 
thing from, for example, Tony 
and Peter Graf in the next 
issue. | don't want to comment 
on all points; with some, | agree, 
but with many, Peta forgets 
some facts {or does not know 
them). Beforehand, | would like 
to say: QPC is great, without 
any doubts, and | also sell it, as 
most of you know. | also sell 
SMSQ/E, so | think | can put 
some things right. 

QPC’s SMSQ/E is adapted by 
Marcel and Tony does not have 
the sources. This logically im- 
plies that Tony first programs 
the changes/improvements on 
the operating systems — for 
AIARIs, QXL, Q40 or whatever, 
and then, afterwards, Marcel 
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adapts it for QPC. Since Tony 
sometimes modifies many 
source files, Marcel often has 
to spend quite some time with 
them. That's given order which 
cannot be changed for obvious 
reasons. 

Regarding the implementation 
of the colour-drivers and ‘slap 
in the face’: a bit, strong, isn't it? 
lf | were in Tony’s position and | 
had had the choice between a 
stable machine with genuine 
Motorola hardware, which we 
know, works (Q40) or an 
unstable slow software-proto- 
col, then it would be easy for 
me to choose - and so it 
probably was for Tony. The 
QXL-PC hardware _ interface 
(designed by Miracle Systems) 
is by far not as good as it could 
(or should) be, and why waste a 
lot of debug time for trouble 
shooting without knowing if it 
is due to the unreliable inter- 


(AGP is now the name). You 
won't find ISA slots in actual 
motherboards because of 
PC99! Watch out QXL fans: get 
a spare board with an ISA slot 
as a precaution .. P2/2 EDO- 
RAMS also have to be ob- 
tained (for Q40) more difficult, 
too. For the tinkerer and QL- 
Hardcore fan the Q40 is the 
only one. 

For everybody else it can only 
be QPC! 

For all you sceptics out there: 
QPC runs for me and, many 
others | know, every day 
without problems. The current 
version 1.54 makes it possible 
to exchange ASCIl data bet- 
ween Windows and the QL 
scrap! 

Additional information about 
QPC, Q40 and everything 
around the Sinclair QL can be 
foundon my redesigned home 
page: http://www.sinclairql.de 
Soon. 


face or the actual driver which 
needs to be debugged? It is 
more than understandable that 
the drivers were implemented 
on the Q40 first. Have a guess 
why Tony used the ATARI Mega 
STE for programming and not 
the so much faster QXL? For 
the same reason - a solid, 
reliable system is required for 
development, and why waste 
time for ruling out problem 
factors which do not exist on 
other systems? 

Moreover, it has taken longer 
for the QXL, because it was 
quite clear that the old QXL- 
PC-software interface would 
be far too slow for the addi- 
tional amount of data required 
for the 65536 colour resolution. 
So the interface had to be 
redesigned as well to make 
sure it would not be dead slow. 
Peta also forgets that QL re- 
venues do not earn a full living - 
for none of us, unfortunately - it 
is probably as much hobby for 
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us dealers than it Is for the 
customers. If we put program- 
ming-time in right relation to the 
revenues nothing at all would 
happen. Therefore | think 
accusations are fairly inappro- 
priate. 

Many people bought SMSQ/E 
for the QXL. They got far more 
than the SMSQ shipped with 
the QXL offered them, and 
most of them got it bundled for 
a third of the full price. This has 
nothing to do with the speed of 
additional implementation, so 
why complain!? 

Yes, and | must correct another 
illusion, unfortunately: a USB- 
driver should allow the con- 
nection and access of all 
possible peripherals!? Ooops, 
no, it would be nice, but each 
USB-device requires its own 
drivers. There may admittedly 
be a common protocol, how- 
ever a printer a mouse, a CD- 
ROM, a modem, a CD writer or 


ll 
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a TV-card cannot be driven by 
the same driver 

Anyway, let's see what the 
future will bring. 

| think Peta provided us with a 
lot of provocative discussion- 
material, and | hope that we will 
have some replies to this in the 
next issue. 

| don't think either that there is 
only black/white, Q40/QXL - 
many users stil use their QLs, 
SuperGoidCards, ATARIs, etc, 
and so do |. 

Regarding the provocative 
statements about the software: 
| prefer to use a Stable program 
with fewer features - it does 
not need to look very fancy as 
long as it does the job | want it 
to do. | don't need 96% of the 
features Word offers me. | also 
don't need the information 


window that Word or Windows 
or whatever has just crashed 
and what | typed was in vain. | 
use Qspread more than any 


QL2000 - The show you can’t afford to miss! 


Geoff Wicks, 28 Ravensdale, Basildon, Essex, SS16 5HU, United Kingdom. 
Tel: +44 (0)1268 - 281826 
Web: http://members. tripod. co. uk/geoffwicks/justwords. htm 


Just Words! - Software for Writers and Word Lovers. 


Did you spot something missing 
in our last advert? 


The answer is in Portsmouth. 


Email: geoffwicks@hotmail.com 


other program since | upgraded 
it last year - you can have a 
look at my harddisk to see how 
many _tab files I've created 
over the last two years. Many 
people speak to me at the 
show, and the fact that they tell 
me about their improvement 
suggestions shows, that they 
use the software. | think many 
users do not believe that 
others still use their QDOS 
compatible system and actually 
work with it - they seem to 
have forgotten that writing an 
application for their own use is 
stil very easy compared to 
other systems. | have seen 
what problems can be caused 
by “today's” development sys- 
tems like Delphi, where nobody 
knows what components do 
internally. Simple things can 
take 5 times as long as with 
BASIC! 

So what do you think? Don't 
disappoint me and write to us! 
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Gee Graphics! (on the QL?) - part 18 


Herb Schaaf 


Matrix operations on 
the QL 


Matrices are such a massive 
mathematical topic that | hardly 
know where to start. I'll just 
Share a few PROCedures and a 
FuNction that seem to do the 
job of getting the “right an- 
swers’. 

There are indications(1) that the 
Chinese were using matrix 
concepts thousands of years 
ago, but the name “matrix” was 
first publicized(2) in 1858 after 
having been used in corres- 
pondence between James Jo- 
seph Sylvester and Arthur Cay- 
ley. Together they developed 
much of today’s matrix theory 
and are described as the "Inva- 
riant Twins’(3). Sylvester was a 
wild, impetuous, poetic extro- 
vert who invented lots of math 
terms. Cayley was a quiet, 
methodical, reserved mountain- 
climbing introvert who wrote 
lots of math works. Both were 
Englishmen who attended Cam- 
bridge. Both showed an apti- 
tude for math. Cayley was Se- 
nior wrangler in the math tripos 
in 1842, and Sylvester took 2nd 
place in 1837. Both took up the 
aw because of religion, Cayley 
in 1849 at the age 28, and Syl- 
vester in 1850 at the age 36. In 
the early 1850's they became 
friends at the Court of Lincoln's 
nn and bounced their thoughts 
off each other Together they 
made a great pair of math 
enthusiasts. | expect there are 
many of you who know much 
more about math history and 
matrices, and your comments, 
insights, corrections, sugges- 
tions, etc. are invited. 

Most of you probably know 
that a matrix can be consi- 
dered to be a rectanglar array 
of “elements” neatly arranged in 
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rows and columns. The “ele- 
ments’ are usually numbers. So 
far all the matrices !ve run into 
are 1 dimensional (row OR co- 
lumn, and referred to as "vec- 
tors’) or 2 dimensional (rows 
AND columns). Do higher di- 
mensional matrices exist in 
higher mathematics? Should 
they? Could they? Are there 
triangular matrices? 

According to MacDuffee(2) ma- 
trices are much more than ar- 
rays. He states “A matrix is a 
number of total matric algebra’. 
Matrices can be scaled, added, 


raised to powers. In a matrix if 
the number of rows equals the 
number of columns then it is a 
“square” matrix and has a 
determinant’, and if the deter- 
minant is not zero then the 
matrix has an ‘inverse’ that can 
act aS a reciprocal. It would 
probably be best if you refer to 
textbooks(5) rather than have 
me try to explain. When index- 
ing matrices some choose to 
count from zero, and others 
count from one. QL S*basic 
can handle either | have cho- 
sen to write my FuNction and 
PROCedures with an option 
base of 1. | like to think we 
might find another clever way 
to make use of the zeroth rows 


and columns later on. 
PROCedure MAT_SCALE(input_mat, scale_factor, output_mat) 
changes every element of an array by the same ratio. 


PROCedure MAT_ADD (mati, mat2, mat_sum) 

adds two matrices to form a sum, both must be the same size, that 
is to say they both must have the same number of rows and both 
have an equal number of columns. 


PROCedure MAT_SUB (mati, mat2, mat_diff) 
subtracts matrix2 from matrixt, both must be the same size. 


PROCedure MAT_MUL (mati, mat2, mat_product) 

multiplies two matrices to form a product matrix, the number of 
columns of the first matrix must be equal to the number of rows of 
the second matrix, and it can make a difference as to which matrix 
comes first(4}. The product matrix will have as many rows as the 
first matrix, and as many columns as the second matrix. 


FuNetion MAT_DET (mat_name) 
returns a single number, the ‘determinant’, from a ‘square’ matrix. If 
the determinant is zero, the matrix is ‘singular’, 


PROCedure MAT_INV(input_mat, output_mat) 

finds the inverse of a ‘non-singular’ square matrix, similar to finding 
the reciprocal of a number. The inverse matrix can then be used in 
matrix multiplication to accomplish ‘matrix division’. 

In MAT_DET and MAT_INV a lot of looping, swapping, and other 
calculating can be involved, and it is possible to have wicked 
rounding errors accumulate. Inputs with ‘reasonable’ numbers will 
probably work out OK, but ‘extreme’ input values might result in 
wierd results. Is there or could there be a LRESPR’able “double” or 
“quadruple” precision S*Basic math package for the QL? 

I've tried to make the MAT_ PROCedures and FuNction general. QL 
S*Basic can call arrays and parts of arrays by name, but mass 
assignment of arrays |s not allowed. 


PROCedure MAT_COPY(from_mat, to_mat) 
is used to make mass assignment of values from the called input 
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array(s) to “working” arrays as well as to transfer the results back to 
a named output array. In all cases we must have created properly 
DIM'd named arrays before we can call them. Inside the 
PROCedures ‘Work. Arrays’ are created, so as to preserve the 


called named arrays if desired. 


PROCedure MAT_SHOW (mat_name) 


orints out the matrix in rows and columns. 


PROCedure MAT_COMPARE(mati, mat2) 

compares two matrices for differences, prints them out and reports 
on the total number of differences found. | use this to check 
textbook answers with QL calculated results. 

MAT_SHOW and MAT_COMPARE are convenient when debugging 


and tracing programs. 


These PROCedures and 
FuNctions seem to work OK, 
but are not especially elegant 
nor optimized. Since we may 
even find a use for some of 
these matrix operations in the 
future, I've started the listing 
"MatFuNPROCs_bas’ with a 
high line number so that we 
can merge it in more easily. 
Apologies to those who abhor 
long listings. 


Projective geometry can go on 
beyond Euclidean geometry 
into Non-Euclidean geometries. 
There we find concepts such 
as homogeneous coordinates, 
and learn that parallel lines do 
meet in ‘ideal points. Far out! 
Matrices are used in computer 
graphics to do accomplish 
rotations, translations, scalings, 
perspectives, and projections. 
Hope we can learn how. 


Notes-- 

(1) Struik, Dirk J.”A Concise History 
of Mathematics” 1976 Dover Publica- 
tions. Inc. New York 

ISBN 0-486-60255-9 

(2) MacDuffie, C.C. "What is a Ma- 
trix?” June-July 1943 American Ma- 
thematical Monthly, Vol. 50 No.6. pp. 
360-365 

(3) Bell, Eric Temple "Men of Mathe- 
matics” 1937 Simon & Schuster New 
York 

(4) Matrices can almost be treated 
like numbers, but there are excep- 
tions. If Matrix A is different from Ma- 
trix B then "Matrix A times Matrix B” 
is NOT equal to "Matrix B times Ma- 
trix A’. Sir William Rowan Hamilton 
became so excited when he disco- 
vered this exception on October 16, 
1843 that he promptly carved it in 
stone on a Dublin bridge. He used the 
terms ‘Linear and Vector functions’ 
instead of ‘matrix’ when he published 
his Dublin "Lectures on Quaternions’ 
in 1853. 

(5) Dover has several less expensive 
paperback classical math reprints. 
Here are a few: "Matrices and Trans- 
formations” by Anthony J. Petto- 
frezzo, "Matrices and Linear Algebra” 
by Hans Schneider and George Phil- 
lip Barker "Fundamental Concepts of 
Geometry” by Bruce E. Meserve. 


20000 REMark MATFuNPROCs_bas 
20010 REMark to go with GG#18 


20020 REMark HL Schaaf August 17, 2000 


20030 : 


20040 DEFine FuNction MAT_DET (mat_name) 


20050 LOCal i, swap_row 

20060 IF DIMN(mat_name,i)<«>DIMN(mat_name,2) THEN 

20070 PRINT #0;"Error - not a square matrix " : STOP 
20080 END IF 

20090 DIM Work_D(DIMN(mat_name,1),DIMN(mat_name, 2) ) 
20100  #MAT_COPY mat_name, Work_D 

20110 determinant = 1 

20120 FOR pivot = 1TOn 

20130 biggest = ABS(Work_D(pivot,pivot)) 

20140 swap_row = 0 

20150 FOR row = pivot TO n 

20160 Abs_element = ABS(Work_D(row, pivot) ) 

20170 IF Abs_element >» biggest THEN 

20180 swap_row = row 

20190 biggest = Abs_element 

20200 END IF 

20210 END FOR row 

20220 IF (swap_row) THEN 

20230 FOR i = 1T0On 

20240 SWAP Work_D(pivot,i) , Work_D(swap_row, i) 
20250 END FOR i 

20260 determinant = -determinant * Work_D(pivot,pivot) 
20270 ELSE 

20280 determinant = determinant * Work_D(pivot, pivot) 
20290 END IF 

20300 IF (ABS(determinant)<1E-10) THEN 

20310 PRINT#O; "Determinant == 0 ":EXIT pivot 

20320 END IF 
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20330 pivot_inv = 1/Work_D(pivot, pivot) 
20340 FOR col = pivot+i TO n 


20350 Work D(pivot,col) = Work_D(pivot,col)*pivot_inv 
20360 END FOR col 

20370 FOR row = pivot+1 TO n 

20380 FOR col = pivot+i TO n 

20390 reduce = Work_D(pivot,col)*Work_D(row,pivot) 
20400 Work_D(row,col) = Work_D(row,col) - reduce 
20410 END FOR col 


20420 END FOR row 

20430 END FOR pivot 

20440 RETurn determinant 

20450 END DEFine MAT_DET 

20460 : 

20470 DEFine PROCedure MAT_INV(input_mat, output_mat) 

20480 LOCal n,i,j 

20490 n = DIMN(input_mat,1) 

20500 IF n «> DIMN(input_mat,2) : PRINT "not a square array " : STOP 
20510 IF n «> DIMN(output_mat,1) : PRINT "rows mismatched " : STOP 
20520 IF n «>» DIMN(output_mat,2) : PRINT "columns mismatched" : STOP 
20530 DIM pivot_flag(n) 

20540 DIM swap_row(n) 

20550 DIM swap_col(n) 

20560 singular_flag = 0 

20570 DIM Work_I(n,n) 

20580 MAT_COPY input_mat, Work_I 

20590 FOR i=1TOn 

20600 biggest = 0 

20610 FOR row = 1 TOn 


20620 IF (NOT pivot_flag(row)) THEN 

20630 FOR col = 1 TO n 

20640 IF (NOT pivot_flag(col)) THEN 
20650 Abs_element = ABS(Work_I(row,col)) 
20660 IF (Abs_element >= biggest) THEN 
20670 biggest = Abs_element 

20680 irow = row 

20690 icol = col 

20700 END IF 

20710 END IF 

20720 END FOR col 

20730 END IF 


20740 END FOR row 
20750 pivot_flag(icol)=1 
20760 IF (irow «> icol) THEN 


20770 FOR col = 1 TO n 

20780 SWAP Work_I(irow,col) ,Work_I(icol, col) 
20790 END FOR col 

20800 END IF 

20810 swap_row(i)=irow 

20820 swap_col(i)=icol 

20830 IF (NOT(Work_I(icol, icol))) THEN 

20840 PRINT#0;" Bad news ! singular matrix ! no inverse"\ 
20850 Singular_flag = 1 

20860 EXIT i 

20870 END IF 

20880 pivot_inverse = 1/Work_I(icol, icol) 


20890 Work_I(icol, icol)=1 
20900 FOR col = 1T0n 


20910 Work_I(icol,col)=Work_I(icol,col)*pivot_inverse 

20920 END FOR col 

20930 FOR row = 1 TOn 

20940 IF (row<>icol) THEN 

20950 temp = Work_I(row,icol) 

20960 Work_I(row,icol) = 0 

20970 FOR col = 1 TO n 

20980 Work_I(row,col) = Work_I(row,col) - Work_I(icol,col)*temp 
20990 IF ABS(Work_I(row,col))<1E-8 : Work_I(row,col) = 0 
21000 END FOR col 

21010 END IF 


21020 END FOR row 
21030 END FOR i 
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21040 
21050 
21060 
21070 
21080 
21090 
21100 
21110 
21120 
21130 


IF NOT(singular_flag) THEN 
FOR swp = n TO 1 STEP -1 
IF (swap_row(swp)<>swap_col(swp)) THEN 
FOR row = iTOn 
SWAP Work_I{row,swap_row(swp)), Work_I(row, swap_col(swp)) 
END FOR row 
END IF 
END FOR swp 
MAT_COPY Work_I,output_mat 
END IF 


21140 END DEFine MAT_INV 


21150 


21160 DEFine PROCedure MAT_SHOW (mat_name) 


21170 
21180 
21190 
21200 
21210 
21220 
21230 
21240 
21250 


LOCal i 
FOR i = 1 TO DIMN(mat_name, 1) 

PRINT mat_name(i,1 TO DIMN(mat_name,2)),\ 
END FOR i 


END DEFine MAT_SHOW 


DEFine PROCedure SWAP(n1,n2) 


ni =ni+n2:n2=ni-n2: ni = ni -n2 


END DEFine SWAP 


21260 : 


21270 
21280 
21290 
21300 
21310 
21320 
21330 
21340 
21350 
21360 
21370 
21380 
21390 
21400 
21410 
21420 
21430 
21440 
21450 
21460 
21470 
21480 
21490 
21500 
21510 
21520 
21530 
21540 
21550 
21560 
21570 
21580 
21590 
21600 
21610 
21620 
21630 
21640 
21650 
21660 
21670 
21680 
21690 
21700 
21710 
21720 
21730 


DEFine PROCedure MAT_COMPARE (mati, mat2) 


LOCal i, j, rows1, colsi, rows2, cols2 
rowsi = DIMN(mat1) :colsi = DIMN(mati,2) 
rows2 = DIMN(mat2) :cols2 = DIMN(mat2,2) 
IF ((rows1==rows2)AND(colsi==cols2)) THEN 
diff = 0: diff_flag = 0 
FOR i = 1 TO rowsl 
FOR j = 1 TO colsi 
diff = matl(i,j) - mat2(i,j) 
IF (ABS( diff) > 1E-6) THEN 
PRINT "at row ";i;" eol "333" diff = ";diff, 
PRINT mati(i,j) ,mat2(i,j) 
diff_flag = diff_flag+1 


END IF 
END FOR j 
END FOR i 
PRINT diff_flag;" differences" 
ELSE 
PRINT "matrices are of different sizes" 
END IF 


END DEFine MAT_COMPARE 


DEFine PROCedure MAT_COPY (from_mat, to_mat) 


LOCal i, j, rowsl, colsi, rows2, cols2 
rowS1=DIMN(from_mat,1) :cols1=DIMN(from_mat, 2) 
rows2=DIMN(to_mat,1) :cols2=DIMN(to_mat, 2) 
IF ((rows1<>rows2) OR (colsi«>cols2)) THEN 

PRINT #0;"Mismatch in MAT_COPY !":STOP 
END IF 
FOR i = 1 TO rowst 

FOR j = 1 TO colsi 

to_mat(i,j) = from_mat(i, j) 

END FOR ; 

END FOR i 


END DEFine MAT_COPY 


DEFine PROCedure MAT_MUL (mati, mat2, mat_product) 


LOCal i, j, jj, k, rows1, colsi, rows2, cols2 
rowsl = DIMN(mati,1) : cols1 = DIMN(mati1,2) 
rows2 = DIMN(mat2,1) : cols2 = DIMN(mat2,2) 


REMark what about a [1 x N] or [N x 1] matrix ? 
REMark ie a row or column vector ? 
REMark transpose into a QL DIM array(1,N) 


IF (colsi AND rows2 AND (colsi«>rows2)) THEN 
PRINT#O; "mismatch in MAT_MUL ! ": STOP 

END IF 

not_colsl = 0 


21740 REMark suppose colsl = 0 (actually = 1) 
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21750 
21760 
21770 
21780 
21790 
21800 
21810 
21820 
21830 
21840 
21850 
21860 
21870 
21880 
21890 
21900 
21910 
21920 
21930 
21940 
21950 
21960 
21970 
21980 
21990 
22000 
22010 
22020 
22030 
22040 
22050 
22060 
22070 
22080 
22090 
22100 
22110 
22120 
22130 
22140 
22150 
22160 
22170 
22180 
22190 
22200 
22210 
22220 
22230 
22240 
22250 
22260 
22270 
22280 
22290 
22300 
22310 
22320 
22330 
22340 
22350 
22360 
22370 
22380 
22390 
22400 
22410 
22420 
22430 
22440 


IF NOT(colsi) : colsi = rowsl : rowsl = 1: not_eolsi = 1 
DIM Work_i(rows1,cols1) 
FOR i = i TO rowsl 
FOR j = 1 TO colsi 
IF (not_colsi) THEN 
Work_1(i,j) = mati(j) 
ELSE 
Work_1(i,j) = mati(i,j) 
END IF 
END FOR j 
END FOR i 
REMark for cols2 = 0 then DIM as column transpose matrix ? 
REMark when QL shows DIMN(array,2) = 0; it is actually 1 !? 
IF (cols2) THEN 
DIM Work_2(rows2,cols2) 
MAT_COPY mat2, Work _2 
DIM Work_3(rows1,cols2) 
FOR i = i TO rowsl 
FOR jj = 1 TO cols2 
FOR k = 1 TO colsi 


Work_3(i,jj) = Work_3(i,jj) + Work_1(i,k)* Work_2(k,jj) 


END FOR k 
END FOR jj 
END FOR i 
FOR i = 1 TO rows1 
FOR jj = 1 TO cols2 
IF not_colsi1 THEN 
mat_product(jj) = Work_3(i, jj) 
ELSE 
mat_product(i,jj) = Work_3(i,jj) 
END IF 
END FOR jj 
END FOR i 
ELSE 
DIM Work_2(1, rows2) 
FOR i = 1 TO rows2 
Work_2(1,i) = mat2(i) 
END FOR i 
DIM Work_3(1,rows1) 
FOR i = 1 TO rows1 
FOR k = 1 TO rows2 
Work_3(1,i) = Work_3(1,i) + Work_i(i,k)* Work_2(1,k) 
END FOR k 
END FOR i 
FOR i = 1 TO rows2 
mat_product(i) = Work_3(1,i) 
END FOR i 
END IF 
END DEFine MAT_MUL 


DEFine PROCedure MAT_SCALE(input_mat, scale_factor, output_mat) 


LOCal i, j 
DIM Work_F(DIMN(input_mat,1) ,DIMN(input_mat,2)) 
FOR i = 1 TO DIMN(input_mat, 1) 
FOR j} = 1 TO DIMN(input_mat, 2) 
Work_F(i, j)=input_mat(i,j)*scale_factor 
END FOR j 
END FOR i 
MAT_COPY Work_F, output_mat 
END DEFine MAT_SCALE 


DEFine PROCedure MAT_ADD (mati, mat2, mat_sum) 
LOCal i, j, rows1, colst, rows2, cols2 
rows1 = DIMN(mat1) :cols1 = DIMN(mati, 2) 
rows2 = DIMN(mat2) :cols2 = DIMN(mat2, 2) 

IF ((rowsl==rows2) AND(colsi==cols2)) THEN 
DIM Work_A(rows1,cols2) 
FOR i = 1 TO rowsi 
FOR j = 1 TO colsi 
Work_A(i,j) = mati(i,j) + mat2(i,j) 
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22450 END FOR j 

22460 END FOR i 

22470 MAT_COPY Work_A, mat_sum 

22480 ELSE 

22490 PRINT "matrices are of different sizes" 
22500 END IF 


22510 END DEFine MAT_ADD 
22520 : 


22530 DEFine PROCedure MAT_SUB (mati, mat2, mat_diff) 


22540  LOCal i, 3, rowsi, colsi, rows2, cols2 
22550 rowsi = DIMN(mati) :colsi = DIMN(mati, 2) 
22560 rows2 = DIMN(mat2) :cols2 = DIMN(mat2,2) 
22570 IF ((rows1==rows2)AND(colsi==cols2)) THEN 
22580 DIM Work_S(rowsi1,cols1) 

22590 FOR i = 1 TO rows1 

22600 FOR j = 1 TO colsi 

22610 Work_S(i,j) = mat1(i,j) - mat2(i,j) 
22620 END FOR j 

22630 END FOR i 

22640 MAT_COPY Work_S, mat_diff 

22650 ELSE 

22660 PRINT “matrices are of different sizes" 
22670 END IF 


22680 END DEFine MAT_SUB 
22690 : 


22700 REMark end of listing MATFuNPROCs_bas 


You and Your Software - just 


Good Friends? 


Part 10 - Commercial and Non-Commercial 


Geoff Wicks 


Correction 

Astute QL readers have poin- 
ted out mistakes in my last 
iwo articles. Last issue there 
was a correction from Wolf- 
gang Uhlig about Easyptr and 
now lan Pizer writes that it is 
possible to get an alphabeti- 
cal directory list in Text87. 
This is done by pressing TAB 
when the unsorted list ap- 
pears. 

Many thanks to Wolfgang and 
lan for making my QL work 
and that of others easier. 
Geoff Wicks. 


Part 10 start here 

When | first started writing this 
series of articles about 18 
months ago | suggested there 
were Skilled programmers, who 
were unskilled in program pre- 
sentation, and skilled presen- 
ters who were unskilled in pro- 
ramming. 
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This statement had been in- 
spired by a program | had been 
evaluating. It did some clever 
things with words, but | was 
never able to discover quite 
what. The programmer, who is 
no longer a QL user had been 
unfortunate because initially his 
program refused to run on my 
system. This was not his fault. 
The problem was a minor ex- 
tension | had temporarily in- 
Stalled while testing another 
third party program. 

| recently looked at his program 
again to discover what | did not 
like about it. After loading the 
program it started by asking 
two questions. The first warned 
about memory, ram disk use 
and extensions that should be 
present. The second asked 
whether or not | was using 
QPC. Were these questions 
really relevant? A plus point 
was that the program correctly 


adjusted to the screen resolu- 
tion, but then the opening 
screen was almost blank. Just 
a request to enter the parame- 
ter file plus a few instructions. 

My immediate reaction was, 
‘What is the parameter file?” | 
oressed D for the defaults. The 
next screen was a list of 17 
parameters, which could obvi- 
ously be amended, and the 
statement “action?”. Again | was 
uncertain, but there was a small 
amount of help, so | pressed | 
for information. 

At this stage | started to de- 
Spair The first information 
screen told me nothing about 
how to use the program. It was 
a long statement of its history 
and the system requirements. 
The next screen listed the files 
on the disk and what the 
program did, but not how to 
use it. After reading four 
screens | was still no wiser | 
then discovered another set of 
information screens, all 6 of 
them. The author had written 
some clever routines for dis- 
playing text on screens of dif- 
ferent resolutions and was 
showing these off, but they 
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were irrelevant to the working 
of the program. | was soon 
wanting to scream out loud, 
“Just tell me what to do’. 

| pressed ENTER to proceed, 
and was told the dictionary 
could not be found. When | 
finally got the program working, 
it was almost an_anticlimax, 
leaving me with a feeling of 
"Was that it?”. When | left the 
program, | discovered it had left 
all its temporary files on my 
hard disk. 

Perhaps surprisingly, | still con- 
sidered this program to be a 
potential commercial product. 
Here was Clearly a skilled pro- 
grammer who enjoyed working 
with words, and who probably 
had the potential to produce a 
range of recreational word pro- 
grams. They would have been 
of minority interest and per- 
haps a little difficult to market, 
but would have still been viable, 
although probably not profi- 
table. What the program lacked 
was the "fun" element and ease 
of use. It needed more visually 
attractive screens and a sim- 
pler way of inputting data and 
parameters to make it addic- 
tive. 

| discussed the program with 
another trader who had also 
been evaluating it. When | said 
the program needed some 
changes, the other — trader 
replied, "No chance. | sugges- 
ted a different front end and he 
just exploded’. With these 
words a potential commercial 
product bit the dust. 

About a year later | was at an 
Eindhoven show, and was 
asked to take a look at a pro- 
gram. It had an instant appeal. It 
looked different from the ave- 
rage QL program, and the 
author had obviously given 
much attention to its design. 
When | discussed the program 
with him, it was clear he had a 
good working knowledge of 
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the Easyptr suite and could ex- 
ploit it to full practical advan- 
tage. As he demonstrated the 
program it did most things he 
claimed for it, Even. without 
hands-on experience, | felt this 
program had commercial po- 
tential. 

The main snag for me was that 
the program did not fit into the 
Just Words! range because it 
was not a word based pro- 
gram. However other traders 
were also taking a close look 
at it, and it is now on sale. 
When | add that it has become 
a SUQCESS, you will recognise 
the program and the author 

A third program | evaluated was 
a Scrabble game. The author 
had put a lot of effort into it, 
and | was favourably im- 
pressed. It was bug ridden, 
making it too easy to cheat, but 
! was reasonably certain the 
author had the skills to correct 
this. Although | would have 
loved to have added the pro- 
gram to the Just Words! range, | 
turned it down without any he- 
sitation. This had nothing to do 
with the quality of the program. 
There was just no way | could 
solve the obvious copyright 
problems. 

These three examples illustrate 
how a dealer must think when 
evaluating a potential new pro- 
duct. It is not simply a matter of 
whether a program works or 
not, or does what is claimed. 
There are also marketing, com- 
mercial and legal aspects. 
When a dealer sells your pro- 
gram or other product, he is 
also laying his own reputation 
on the line, and taking calcu 
lated financial risks. In the QL 
world these risks can be very 
real. The financial loss to Just 
Words! caused by the collapse 
of IQLR was greater than 13% 
of that year’s income, and over 
5 times the gross profits for 
that year 


It is therefore reasonable that a 
dealer places demands on a 
software author to make his 
program more commercially 
attractive. When he does this, it 
is not necessarily a criticism of 
the program or the program- 
mer It is just that the dealer has 
the better knowledge of what 
QL users are wanting, and how 
they will react to the product. If 
a software author is unwilling 
to make changes to his pro- 
gram before commercial re- 
lease, then how will he react if 
the first users discover a bug 
or request new and improved 
features? A trader has to be 
able to trust his software au- 
thors to produce the final pro- 
duct QL users are wanting. 

lf you have written a program 
or routine you think may be of 
wider interest, do not be afraid 
to discuss it with other users 
and traders, but do not expect 
an easy ride. If it does have 
commercial potential you will 
not be on your own. The trader 
will be there to offer help in 
rewriting the program or will 
know the people who can help 
in rewriting. Even if you are not 
a skilled programmer, but have 
a viable idea, we may be able 
to make a commercial product 
out of it. The important point, 
no matter how good or how 
bad your programming is, is a 
willingness to be flexible, to 
learn and to make changes. 
The QL community is full of 
creative people. Their talents 
should be shared. 


This series is now complete. It 
has been well read and attrac- 
ted a lot of interest. Many 
thanks to all for the many 
comments and feedback. 
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Im stillen Winkel 12 D-47169 Duisburg 
Tel. 0203 502011. Fax 0203 502012 
| http://www.j-m-s.com/smsq/index.htm 


New Version DM 249-- 
Upgrade from QPC2 DM 79,90 
Upgrade from QPC1 DM 129,90 


For Upgrades, we need the 
Master Disk back (as always)! 


TERMS OF PAYMENT 
| Postage and package [Germany] DM 8,99 (if total value of goods is up to DM 50,- then only DM 5,99). [Europe] DM 14,50 {i 
| total value of goods is up to DM 50,- then only DM 9,50). [Overseas] between DM 14,50 (1 item) and DM 35,~ slpexmany: Al 


© } 


prices incl. 16% V.A.T. (can be deducted for orders from non-EU- countries). 3 


| EOE. Cheques in DM, EURO, Eurocheques and Credit Cards accepted. _ VISA 
| aan 
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More on SERNET 


Tim Fuller 


The four articles on SERNET in QL Today Volume 5 Issue 1 were 
of great interest to me as | have acquired a Q40 and now have 
the task of copying many megabytes of files from my Aurora 


hard disk to that of the Q40. 


SERNET seemed just right for 
the job, so | made up a lead 
with 25-pin connectors on each 
end according to Figure 1 in the 
article by Dilwyn Jones. To test 
he lead | tried copying files 
between sert on the Q40 and 
ser3 of the superHermes on 
he Aurora, and found it would 
copy only to the Q40. The 
reason must be, | think, that in 
he first place superHermes 
thinks it is connected to a real 
modem so does not expect to 
receive any data from the line 
until a Carrier has been detec- 
ted by the modem, and in the 
second place superHermes 
does not contain a pull-up resis- 
tor to assert the DCD signal 
when the pin is not connected. 
Presumably the Q40's serial in- 
terface does have such a pull- 
up, and a QL serl or ser2 
would not need DCD as these 
interfaces have only one hand- 
shake signal in each direction. 

My theory is supported by the 
fact that file copying was pos- 
sible in both directions when | 
had connected DCD to DSR at 
each end of the lead, though | 
should have been able to get 
away with the connection only 


at the superHermes end. How- 
ever | wanted the lead to be 
generally useful. So | conclude 
that a true null modem lead 
should have DCD connected to 
DSR at each end. The pins will 
be 8 and 6 on a DB25, but 1 
and 6 on a DB9. 

The reason | tested my lead on 
ser3 was force of habit, as | 
know from experience — that 
ser3 works faster and more 
reliably than serl and ser2 on a 
QL. Also | hoped | could de- 
ceive SERNET into thinking 
ser3 was ser2 by using the 
redirection facility provided by 
the ipcextuk_bin resident ex- 
tensions that come with super- 
Hermes, despite the warnings 
in the articles. However this did 
not work, so | have been using 
the Qpac2 Files menu to back 
up my Aurora to the Q40 using 
ser2 at 9600 Baud. It does 
seem slow, but | can see pro- 
gress when the Q40 hard disk 
activity light flashes regularly. 
Sometimes though the flashing 
stops, so | assume that then 
SERNET is repeatedly trying to 
send the same packet without 
SUCCESS. 

SERNET would be much more 


useful to SuperHermes users if 
it could be made to work with 
ser3. The speed would be four 
times greater perhaps more 
because of the increased reli- 
ability. It appears that SERNET 
does not work with ser3 be- 
cause It opens separately the 
receive and transmit sides of 
the serial port it is using (see 
pages 35-37 of the SMSQ(E} 
manual). If this is essential to 
SERNET and cannot be altered 
there would still remain the 
possibility of having superHer- 
mes allow separate opening of 
stx3 and srx3. | wonder if there 
Is anyone willing and able to do 
the work? 

Jochen replies: Tim is abso- 
lutely right: independant re- 
ceive and transmit channels 
are essential for SERNET The 
reasonable solution would be 
a driver for superHermes 
which also supports indepen- 
dant rx and tx channels. 

But you can double the speed 
by cheating: SER2 sends 
happily at 19200 baud, and 
SER3 receives at 19200 baud. 
If you make up a special cable 
with three connectors, two at 
the QL side which connect to 
SER2 for transmission and 
SER3 for receiption, and con- 
figure SERNET to use SER2 
and SER3, then you can not 
only double the speed but 
also use SERNET on non- 
SMSQE machines (ooops, I'm 
cutting sales here!) 


The PW function 


Programming ProWess in 
SBasic - Part 3 


Wolfgang Lenerz 


As promised last time, we will now look a bit 
closer at the PW function. We have already seen 
this in the example program (line 210), but | 
haven't really explained what it does and why it 
is necessary, SO here goes: 
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As you will have noticed in the description con- 
cerning the PWcreate keyword, you have to give 
this keyword a type followed often by several 
tags. This is also true for other keywords, nota- 
bly PWehange and PWquery which we will see 
a bit further on. Now, types and tags are actually 
numerical values, ie. the tag "TYPE_OUTLINE” is 
equal to the value $4F55544C and the tag 
“POSITION_BELOW" is equal to the value 
$11000004. In other words, they are numeric 
constants. 
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You can, of course, use these direct values in the 
functions and keywords instead of the pretty 
names. So you could write 
object=PWereate(0,$4F5554C,....) 


thus creating an outline type. This however, is not 
very legible, and then you would have to know 
the value of each tag. in the documentation, only 
the names are given, not the numerical values. 
Also, the code would not be very readable... 


Moreover, since there are over two hundred tags 
and a few types, this would mean that learning ail 
the values by heart would be a bit difficult. This 
problem doesn't exist for ‘C’ or assembler pro- 
grammers who can define ‘include files’ which 
contain all of these values and define them as 
variables’, since these variables later no longer 
exist, but this is not really feasible in basic. 


One could, of course, simply have a procedure 
initialising all the variables, something like: 
DEFine PROCedure init_tags 
TYPE_OUTLINE = $4454544C 
POSITION_BELOW = $11000004 
(.. and so on for the 220 remaining tags) 
END DEFine init_tags 


and then re-use that procedure in every program 
using Prowess. 

Since there are more than 220 definitions like 
that, each Sbasic program in Prowess would 
already be at least 220+ lines long (or if you 
number in increments of ten, lines 10 to 2210+ 
would already be taken..) without you having 
done anything! This would lead to an inflation in 
program size, and every SBasic program in 
Prowess would have to include this, making the 
inflation even larger stilll 


This is why the PW keyword exists. It is a 
function which takes as parameter the name of a 
type/tag and returns the value for it. 

Thus, PW is a function, used as follows: 
result=PW(tag$) 


tag$ is the tag or type to get. It would be best if 
this were within quotes. It is possible to leave it 
without quotes since the keyword should be 
intelligent enough to figure this out. However 
leaving the quotes out might give rise to pro- 
blems when compiling your program later on, so 
it is preferred to give the name of the tag 
between quotes. 

The names for the tags (and types) can be found 
in the part of the Prowess Sbasic Interface 
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manual containing a detailed description of them. 
lf you have a look at the manual, you will notice 
that they all start with PW’, and have the format 
PW{'name’) - e.g. PW(TYPE_OUTLINE}. The 'C’ 
manual uses the entire name, including the ‘PW_’. 
In the PW function, you only type the name part. 


lt doesnt matier whether you write the actual 
name in upper or lower case. However, since in the 
manual they are all described in upper case, this 
has beenused throughout this series (as well as in 
the SBasic manual) and in all of the examples. 

As an example, in the manual, you might find the 
name PW(‘OUTLINE_QUIT_ACTION’} for a certain 
tag. In SBasic, you would thus write: 
object=PWereate(...., PW( ‘OUTLINE _QUIT_ACTION') 

.) 


There, that wan't too difficult, was it? 


And now, for something completely different. 


Using strings in Prowess 

Whilst using Prowess in SBasic is generally not 
very difficult, curiously enough, one must pay a 
little bit more attention to what one does with 
Strings, if they are used as parameters for the 
PWxxxx keywords. (This short explanation does 
not concern the PW function explained above 
nor the other keywords which don’t start with 
‘PW', where strings are handled normally). Some 
of the tags or types passed to the keywords 
use string parameters: for example, the text in 
the title of an outline object. Uniess you adhere 
to the rules explained below, there can be a 
Slight (ahem) problem. But first, a little history 
lesson Is in order: 


A little history 

The potential problem here stems from the 
question: how long is a piece of string? This 
happens to be not only a bad pun, but also the 
true reason things get so involved here. It was 
originally foreseen that Prowess would be pro- 
grammed in 'C’ (and, possibly, Assembler}. To a 
large extent, Prowess itself is programmed in 'C’. 
The 'C’ language uses a certain way to deter- 
mine how long a string is: it starts at the start of 
the string (it knows where that is), and then 
Strings along (groan) until it finds a \O, ie. a 
CHR§(0). It then knows where the end of the 
String is, and so it can determine how long the 
String itself is. 


As you may know, the QL normally uses another 
way of handling strings: the characters of the 
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string are preceded by two bytes, which contain 
the length of the string. So, there is no CHR$(0) 
at the end, and the same string ‘Isn't computing 
great’ looks, in memory, as follows: 


in normal QL mode: 

(length word) Isn't computing great 
and in 'C: 

Isn't computing great0d 


Use CHR$ 

Of course, these two ways of doing things are 
incompatible... This means that you, the program- 
mer must make sure that your strings always end 
with a CHR§$(O) as is required by Prowess: if you 
pass a string variable (such as a$), make sure 
that a$ contains a CHR$(0) at the end: 
a$=a$&CHR$(0). Likewise for arrays: if you pass 
(part of) an array, this must end with CHR§(O): 


DIM B$(20,40) 
B$(5)=B$(5) &CHR$(0) 


Strings are not copied 

The strings you pass to Prowess are not always 
copied to a safe place, since Prowess in many 
cases thinks (just like most 'C’ programs) that if 
yOu pass it a string, then you should damn well 
keep the string until it has finished. This means 
that you cannot pass a direct string (e.g. some- 
thing between quotes), or the result of a string 
function, to any of the PWxxxx keywords, you 
must always pass them a string variable (with the 
CHR$(0)} at the end). 

Moreover, this string variable should not be a 
LOCal variable, since these are thrown away 
when you quit the function/procedure where 
they were declared (unless you are sure that the 
object won't need the string any more when you 
quit the function/procedure, e.g. if you remove 
the object before leaving the function/proce- 
dure) 

Fortunately enough, there are one or two 
exceptions: Some of the tags allow a string para- 
meter with ‘COPY’, which means that Prowess 
does copy the string to a safe place. In these 
cases you can pass a direct string. These tags 
generally contain the word ‘COPY’ at the end, so 
they are easy to recognise. This is also men- 
tioned in the manual where the types and Tags 
are detailed. 


The rules for passing strings 
In short, here are the rules for passing strings: 
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IF the tag with which you use the string, is a 
COPY tag, you can use any kind of string: 

- string variables, LOCal or global 

- (slices of} string arrays, LOCal or global 

- direct strings 

- (results of) string functions 


IF the tag is not a copy tag, use only: 
- global string variables 
- (slices of) global string arrays 


but do NOT use a direct string or a string func- 
tion. You MAY use LOCal variables if you are sure 
that you won't leave the function/procedure 
where they are declared before removing the 
object. 


In all cases, append a CHR$(0) at the end. 


Attention, string functions are not only those you 
make yourself in Basic and which return a string, 
but also such machine code functions as "&’: 
Never pass as parameter: 

a$&CHR$(0) 

but always write 

a$=a$&CHR$(0) 

and then pass a$. 


Finally, one small bonus: whenever you can pass 
a direct string (or string function), there is no need 
to append a CHR$(0) at the end, this will be done 
automatically. 


Array handling 

In the 'C’ interface, some tags allow you to pass 
string arrays (for example 
PW('MENU_ADD_ARRAY’). It has been attempted 
to keep this functionality, so that you can also 
pass SBasic arrays to the corresponding SBasic 
keyword. This is no problem, if you keep the 
following in mind: 


» All array elements must end with a CHR$(0)}. 
The reason for this is explained above. 

-» Only pass a two dimensional string array (e.g. 
DIM a$(10,20)). 

-> When you pass an array after a tag requiring 

such an array, the array itself is generally pre- 
ceded by two numbers which contain: 
- The number of the elements in the array. This 
is quite straightforward and should correspond 
to the first dimension of the array (ie 
DIMN(a$,1}+1, which would be 11 in the above 
example). The "+1" is due to the fact that arrays 
Start at element 0, but DIMN returns the 
number of elements as used in DIM. 
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- The maximum length of each element of the 
array +2 (or 3). The maximum length is of 
course the second dimension of the array (ie. 
DIMN(a$,2), which is 20 in the above example). 
You must always add either 2 or 3 to this 
number - 2 if the length of the array is an even 
number, 3 if it is an uneven number This takes 
care of the two bytes in front of each element 
of the array and which, as is usual in the QL, 
contains the actual length of this element of 
the array, and of the possible padding byte if 
the length of the elements is uneven. | would 
recommend you always use arfays of an even 
second dimension, so you can forget about 
whether you should add 2 or 3 and always add 
2 automatically... 
-- Don't forget that arrays start at element 0! 
Example: 
DIM a$(2,20) 
a$(0)="Element one'&CHR$(0) 
a$(1)="Element two" &CHR$(0) 
a$(2)="Element three"&CHR$(0) 
(...) 
xobj=PWereate(...PW( 'MENU_ADD_ARRAY'),3, 
DIMN(a$,2)+2,a$,...) 
a more generic example: 
DIM a$(x,y) 
a$(0)="Element one" &CHR$(0) 
a$(1)="Element two" &CHR$(0) 
a$(2)="Element three" &CHR$(0) 
(s2s.) 
a$(x)="Element x"&CHR$(0) 


e) 


= 


length=DIMN(a$,2)+2 

length=length + (length && 1) 
xobj=PWereate(...PW('MENU_ADD_ARRAY'), 
x+1, length, a$,...) 


The length=length + (length && 1) part of this 
program makes sure that 1 is added to length if 
length is uneven: (x && 1) returns 1 if x is uneven, 
and 0 if it is even. 


Some additional string handling 
keywords 


There are also some additional keywords con- 
cerning string handling, the purpose of which is 
to make some part of the string handling a bit 
easier: 


MKSTRINGS 

sometimes, some of the query or change tags 
do not return a string, but a pointer to a string. 
This is an address where the string lies in the 
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(completely useless) 'C’ format. The MKSTRINGS 
function looks at the string located at that 
address, and returns it to SBasic as a real string. 
The Syntax of this function is as follows: 
String$=MKSTRING$( address) 


where address is the address returned by 
Prowess. 

Example: 

1_item_t=PWquery (my_loose_item_object, 
PW('LOOSE_TEXT', )) 
item_text$=MKSTRING$(1_item_t) 


This queries the item (a loose item) and gets a 
pointer to the text of the item from it, and then 
makes a string out of this, which is returned in 
item_text$. 


MKLEN 

Some of the Prowess calls will set a string 
passed to them to a new value. Of course, 
Prowess only sets this in the 'C’ format - ie. it 
forgets to set the new length of the string in the 
precedding length word (actually. Prowess 
doesn't even know that there is a length word 
before the string). MKLEN does that - it makes 
sure that a string passed to it will be the correct 
length - it stops just before the first CHR$(0) in 
that string. Use this only when the string was 
modified by Prowess, ie. when it is a (call and) 
return parameter to Prowess. The length of the 
string that will be set does not count the 
CHR$(0) at the end - in other words, this will no 
longer be part of the SBasic string. 


The Syntax of this keyword is: 
MKLEN string$ 


MKLENO 
This does the same as MKLEN, but keeps the 
CHR$(0) at the end. 


Both of these keywords should be used ONLY 
when you are sure that there is, indeed, a 
CHR§(0} at the end. If not, and especially in a 
compiled program, It could happen that the 
variable stops where another starts - without a 
CHRS(0} to separate them! The new length 
would then count until the first CHR$(0), 1e. at the 
end of the next variable (perhaps). 


In the next instalment of what is no longer really a 
mini-series, we'll try to refine our example pro- 
gram a little bit. 
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QD 98 £45.00 || £79.00 


QD + QBasic £59.00 | Irypset 94 £29.00] 


QD + Qliberator + QBasic £100.00 | [ro ntext 94 £ 39.00 
Qliberator £50.00 | |2488 drivers £ 29.00} 
Master Spy v 3.3 £30.00 | JEpson ESC/P2 driver 


QPTR £30.00 || £26.00 | 
Easyptr pt 1 & 2 (together) £30.00 | | Mee’ the only 2005) 
Easyptr pt 3 (C library) £14.00 : capalile fhniae the | 
QMake £15.00 | | full screen on the Aurora 
QMon / Mon £22.00. | |/Se/sremeen te 
Basic Linker £19.00 | \___peing written. J 
DISA 3 £31.00 


QMenu £14.00 | 


Big news this month is that we have dropped the prices on 
many of the items that we have to buy in from Europe. 
The continuing weakness of the Euro on the exchange 
markets has allowed us to make large cuts in the prices of 
software from Jochen Merz, Progs etc. We are now. selling \ 
QPC 2 for only £82.00 to ‘non SMSQ/E owners and ~£67.00 
pounds to those who already have a copy of SMSQE for a 
different platform. We, will only be able to keep prices. tisis 
low as long as the Euro remains weak so buy now and~ 
take advantage. the situation. 


Just Words' by Geoff Wicks \ _ UTILITIES 


FiFi 2 £ 18.00 
THESAURUS, STYLE CHECK, SOLVITPLUS 3 | | Qsup £28.00 
| £10.00 ea / ANY 2 PROGRAMS £ 18.00 / ALL 3 PROGRAMS £€ 25,00 | QSpread v2.04 £48.00 


(includes Pointer and non-pointer driven versions) 
(PE, versions need Hot_rext, WMAN and PTR_GEN or SMSQE to run} Cueshell 2 £25.00 


Upgrades from previous versions £ 2.50 + S.A.E. New Manuals £ 1.50 
Qload/Qref £15.00 


| QL2PC-New program I! Disk Mate5 £16.50 
| Convert text files from QL to PC formats ott ° QPAC 1 £20.00 
| and much more ! AIM supp | QPAC 2 £ 40.00 
| Onl with : 
my £10.00 Now | QTYP 2 £ 30.00 


Spelling Crib : PD program £ 1.50 +SAE QLQ £ 28.00 } 
or Free if you buy ail three programs —— ———— 


(We are currently out of stock of the SuperBasic Reference Manual 
Place your order now to get one as soon as it is reprinted 


| The SBASIC / SuperBASIC Reference Manual ( Over 500 

| The complete definitive guide to Eicie programming in QDOS/SMSQ including | Pages! | 

| three disks of PD toolkits, example procedures and an electronic index. £ 40.00 
compiled by Rich Mellor, Franz Hermann and Peter Jaeger ; 


| + postage | 
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[1 Tel +44 (0) 1273-386030 fax +44 (0) 1273-38157 
| Mobile +44 (0) 7836-745501 


| O Branch 


Fe veling out on a limb ? 
Reach out for Q Brancb. 

Suppliers of Quality DDOS/SMSO products * 

Hardware and Software. 


20 ) LOCKS HILL, PORTSLADE, 


Hardware 
: We have a small stock of second user iterns. Auroras} 
/ Qubides / Gold Cards / Qplanes / superHermes etc. | 

call us to get details of the items available. These | 


V4 2 are going fast so call soon. = 
SUSSEX. BN41 2LB. UK: : Super Gold Cards £& 125.00" 
% oe QXL £ Call S| 
P roWesS A Recycled superHermes £ 80.00 “SH 
ProWessS (now free J) £ 1.60 8 Recycled Gold Card £ 60.00 * 
DATAdesign £20.00 | & | Recycled Aurora £75.00 * 
Fontutils £ 28.00 = Aurora £90.00 
File Search £11.00 | ® | Qubide £55.00 
pst ited 3 Pe cables = a 
choncrommes ECAR || Atromromadenor £300 
Pwile e1750 | ¢ | ArfaBraquet’ £ 8.00 
= Son of Braquet £18.00 
Paragraph The 'Braquet £ 16.00 
MC plate £ 6.50 


The ProWesS word processor 
Demo version £ 1.50 + postage 
Full Registered version £18.00 | 


* when available. 
14" and 15" monitors for the Aurora - Call. 


Q Branch Pro ograms 


nis 
The Knight Safe3_ py VER £35.00 
upgrades from Be versions E 5.00 


Q - Route v1.08C ! £ 25.00 
Route finding programme gsfON 
Ww 


ysion 3.03 available now 
fo 


SMSQ/E 


Gold Card / Atari / QXL Version 


00 


Various Atari versions : call for details 
The Colour Drivers are running on the Q Branch Q 40! 
Coming to a computer near you in 2000! 


, QPC 2 is here ! 
| £ 82.00 (£ 67.00 SMSQ/E Owners) 


Upgrades from QPC 1 £ 27.00 
(return master disk) 


Please Note our 


Q - Count : £ 25.00 


Pointer driven home accounting 


The Fractal Collection ! 


This is a brand new program which will preduce stunning | 
animated fractal patterns. It will run on anything froma | 
Gold Card to the Q40 and will be capable of using the 

power of the colour drivers when they are released. [ 
Complete with many example files and routines to design | 
your own screens. 


Only £ 35.00 _ 


i Special offer ! 
\Get Cueshell for only £15.00 with any copy of SMSQ/E 


There are so many extras available for the Q 40 Q 40 aad mae 16Mb RAM & 0 car £ 330.00 - 
that it is hard to list therm here. If you are + SMSQ/E £ 30.00 
interested in one of these boards than contact us Extra 16 Mb RAM £ 30.00 
and we will supply the details. the basic prices are Tower Case £ 45.00 
shown here. All prices do not include shipping. _ 


We « can accept payment by VISA, Mastercard and Switch. You can also pay By ] a 
Eurocheques made out in Sterling or a Sterling cheque drawn on a UK Bank.) Gig 
Prices include Post and Packing in Europe. 
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Q40/Linux Journal 


Tim Swenson 


About 10 years ago, | was 
editing the Captial Area Timex 
Sinclair User Group Newsletter 
| found that there were a num- 
ber of articles on programming 
that | wanted to write, but | felt 
they really did not fit the rea- 
dership of a User Group letter. 
So, | decided to create a news- 
letter just for such articles, and 
the QL Hacker's Journal was 
born. 

Now with Linux available on the 
Q40, the discussion of Q40/ 
Linux related issues really don't 
fall within the scope of a QL 
publication like QL Today, Given 
that a good idea can still be a 
good idea 10 years later I've 
decided to create the Q40/ 
Linux Journal. 

The aim of the Journal is to 
cover topics that apply directly 
to running Linux on the Q40. 
General questions about how 
to create user accounts, how 
to change file permissions, etc. 
are best left to the whole horde 
of Linux books available. The 
Journal will focus on topics 
such as; using the sound on 
the Q40 with Linux, support for 
ethernet cards, features of the 
newly ported kernels, what 
packages have been tested 
and work on the Q40, and so 
on. 

The audience of the Journal is 
from the experienced Unix 
user (and know that there is still 


a lot to learn) and the relative 
newcomer to Unix that is trying 
Linux because it is available on 
the Q40. My first goal is to 
document the things that | want 
to know and add other areas 
that readers would like to see 
covered, 

've been thinking about this 
Journal for a number of months 
and have thought about how 
best to approach it. | had 
thought that a single, updata- 
ble, document would be the 
best way to document using 
Linux on the Q40. The down- 
side to this idea is that it would 
be kind of difficult for users to 
keep track of which version of 
the document they have, and 
what recent changes went into 
the document. With a Journal 
format, users would know what 
is new as it would all be in a 
single document. 

The best medium for distri- 
buting the Journal is via the 
ql-developers mailing list. As 
much as it is listed as the 
ql-developers list, it is really the 
Q40/Linux mailing list. | don't 
know if all Q40/Linux users are 
on the list, but | do believe the 
majority are. | plan to post each 
issue to the mailing list and 
then place it on my web page. 
With past issues being on a 
web page, anyone coming late 
into the Q40/Linux world can 
quickly get up-to-date with 


Why always me...? or How bad 
luck turns into something positive 


Jochen Merz 


In the past few weeks | have 
had very bad luck in terms of 
hardware problems: first, the 
fast serial port SER4 of my 
main ATARI Ts — died 
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(permanent shortcut in the 
serial cable). Rather tragically 
for me, since this is the fastest 
port and | used it to connect 
my two TTs via SERNET This 


what's going on, and hopefully 
use the Journal to answer 
questions before posting them 
to the mailing list. 

The ql-developers mailing list 
has been a good source of 
information, and with the list 
archive, the discussions can be 
documented for posterity. But, 
it can take some time to plow 
through the archive to find the 
right answer to a question. A 
lot of the discussions going on 
are the group, collectively figu- 
ring out the answer to a pro- 
blem, sometimes taking a 
wrong turn. The advantage of 
the Q40/Linux Journal is that it 
will be documenting the 
answer after it has been found. 
Being a good procrastinator, | 
do not have an Issue ready, but 
by making such a_ public 
statement pretty much puts me 
on the hook. | do have some 
ideas for articles and do know 
who to ‘volunteer’ to write on 
areas that they know. 

Like the QHJ, the Q40/Linux 
Journal will probably come out 
on an irregular basis, depen- 
ding on what new work has 
been done and what new 
things users have tried. Like 
the QHJ, | know that feedback 
will be limited, but | do hope 
that the work involved with be- 
nefit the QL community. 

Now | need to go forth and get 
the first issue done. | hope to 
have the first issue ready for 
the QL 2000 show. 

To get on the list, send an email 
to Bruce@qltoday.com 


ensures that | have always the 
same data on both computers 
as a backup - which Is a pretty 
Safe method. Other serials 
ports are occupied by the dot 
matrix printer modem etc. and 
can only handle a maximum of 
19200 or 38400 Baud. The 
mailbox TT's serial ports are 
also used up completely by 
the modems etc. 
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If that was not enough: my 
main TT died one day after the 
Eindhoven meeting. A strange 
smell, and a few moments later 
it was dead. OK - power-sup- 
ply swapped - nothing, no sign 
of life. Panic! 

There is a reason why | call 
this TT my ‘main TT’, | use it 
for virtually everything (calcu 
lations, invoices, programming 
etc.) - except for internet ac- 
cess. And just as bad: | also 
still use it aS a native ATARI, in 
order to print QL Today on it 
and do the layouts. 

But | had still the Q40. Because 
it was still lacking 4 serial ports 
it led a shadowy existence and 
| actually took it only to QL 
meetings. Well, a very good 
replacement for the QL/SMSQ 
part of the TT The TT's hard- 
disk had survived, but it is not 
possible to connect this SCSI 
harddisk (or my  Syquest 
removeable, SCSI too) to the 
Q40. But the solution was rela- 
tively simple: connect this hard- 
disk to the mailbox TT and 
transfer via SERNET to Q40. 
The main problem was_ to 
having only two serial connec- 
tors on the Q40. One was 
already used by the mouse, so 
only one remains. So | have to 
use it for the printer some- 
times for SERNET sometimes 
for a modem to send faxes. 
Not the best solution, but what 
could | do..? | was glad to have 
a working system. 

Very positive: The speed of the 
Q40 is impressive! | am using 
the Q40 now for some time and 
am very positively surprised. All 
my programs run - much faster! 
Unfortunately | did not have 
much time due to whole bad si- 
tuation and the time lost there- 
by did not allow me to ex- 
periment with the colours (But 
George Gwilt has dealt with the 
colours in detail in his article). 
The solution for the lost ATARI 
side of the TT was not so 
simple, unfortunately. There is 
Calamus for the PC, but this 
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meant | had to get all my data 
from the ATARI to the PC. For- 
tunately, | still had another SCSI 
removeable drive, which works 
both with the PC and with the 
ATARI. Only one single 32MB- 
Partition was allowed to exist, 
otherwise the PC does not like 
the ATARI format - and the PC 
does not support more than 
one partition on one medium, 
but better this way than no- 
thing at all. After some hours 
all my data was on the PC. 
Windows prints correctly if you 
orint to a printer connected to 
the parallel port. But if the 
same printer is connected via 
serial (the parallel port goes to 
the Q40 and ! do not want to 
swap cables here too, like | 
have to do on the serial port of 
the Q40 as mentioned before), 
then some different data is 
sent and the printout is never 
correct. Solution: new printer 
drivers from the Internet. Not 
quite, even more faults in the 
printout. No solution - swap 
cables! | won't continue with 
the problems | have with the 
ATARI-PC solution, it probably 
wont interest you. 

On with Q40.| had to get used 
to it slightly. The screen reso- 
lution is similarly to the TT and 
easily readable on a 17’-monr- 
tor You have to have at least a 
15°, 14° is too small. But even 
17’-monitors do not cost a for- 
tune nowadays. The TT can 
only handle 4 colours (QL 
mode 4), the Q40, however 
has 65536 colours, the stored 
displays occupies much much 
more memory than before. | 
could easily start 30 display- 
filing QSpreads to the 20MB of 
my TT without running out of 
memory. Q40 already com- 
plains about starting the 8th 
QSpread. Each job grabs 
about {MB only for memory to 
store the display background. 
For the mailbox functionality, 
for which my Q40 was actually 
planned, 16MB is enough; but | 
would recommend to every- 


one to equip Q40 with 32MB. 
After few days only plugging 
the cables all the time was get- 
ting on my nerves and | deci- 
ded | had to get a new Serial 
card. At first, when | got Q40, | 
had two cards (hard disk, flop- 
py, 2 Ser 1 Par} in the computer 
but there were interrupt con- 
flicts (the well-known PC pro- 
blem - and PC cards are used 
in the Q40) and so | had to 
remove a card. It took some 
searching, but | got a freely 
configurable ISA card (no 
Plug&Play), not inexpensive, 
but available. The card has 4 
serial and 3 parallel interfaces 
and must therefore be put in 
together with a card which 
holds the HD interface, floppy 
controller etc, otherwise | 
would have no floppy and hard 
disk. Soon | had the mouse 
working on all four serial ports 
- | was happy! 

All three PARs also worked at 
the first attempt. Wow! 

Too much luck for me, proba- 
bly, the Q40 did not want to 
speak to my other TT via 
SERNET | had gone through all 
the configurational possibilities 
but it wasn't until | used a serial 
interface tester at SER4 and 
figured out that SER4 of my 
other TT was totally dead - all 
lines with the exception of 
Carrier Detect were gone. No 
idea what has killed it. Whether 
it was simply an unfortunate 
coincidence or a result of this 
short-cut - no idea! Especially 
since serial ports are desgined 
for “hot plugging” and should 
survive wrong connections 
and short-cuts. But the com- 
puters have their age and 
were also very reliable for 
many, many years. 

| thought: use a slower port... 
better than nothing at all. But, 
as soon as one sends data 
faster than 300 Baud, half or 
more of the date gets lost on 
the receiving Q40 side. Again 
in a deadiock!? Despair many 
telephone calls with Tony 
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Tebby, trial, and now finally the 
Serial ports work. There must 
be only one interrupt per port, 
otherwise hardware problems 
arise. lony’s software can han- 
die all devices sharing one 
interrupt, but as soon as more 
than one device is connected 
to the same interrupt, they 


fight for the interrupt level. The 
new card is, fortunately, very 
freely configurable, so that | 
can take e.g. 7 and 11 for serial 
port 3 and 4. It works! Hurray! 
Still better. my main TT arrived 
back from repair | copied eve- 
rything back, and the Q40 can 
take over the mailbox TT and 


do the job | bought it for 

At present | copy the mailbox 
data over a slower port, the 
Q40 should soon replace the 
mailbox TT and you should 
benefit from faster BBs’s. More 
(hopefully) in the next issue. 

3 days later the Q40 has 
replaced the BBS TT! 


Letter-Box 


Jerome Grimbert writes to tell his experience of 
the new colour drivers for the QXL: 
last evening, | made some additional experiments 
with disp_colour: 
contrary to what | read, it is possible on the QXL 
to switch between the GD2 driver and the old 
one (and vice-versa]: 
| started in 1024x768 x 16 bits. | never was able 
to get 1024x768 x mode 4/8; but 
disp_colour 0,800,600 
does work and puts the display in 800x600 x 
mode 4/8 
disp_colour 3,800,600 
does work also, giving the 800x600 x 16 bits. 
Also 640x480 did work fine. 
But | never succeed to get 512x256 working, 
even when starting with SMSQE configurated to 
912x256x16 bits (display shows garbage). 
But the good news is that it means that text87 will 
not require a reboot to get the right screen mode... 
My web pages for the QL are now at 
http://www.crosswinds.net/~ grimbert/al 
which includes my High Colour Sprite Editor 


W. Wright writes a response to the keyboard 
interface help request in QL Today: 

In reply to John Rish "Desperately seeking...” 
query in QL Today Volume 5 Issue 2. 

It is a Schon PS/2 keyboard interface. | obtained 
one from TK Computerware in 1989. 

The kit comprised the interface, a modified QL 
top case, a PC type keyboard. The top case had 
the key area cut away and resulting hole being 
covered with a piece of fibre board fixed with 
small self tappers at the corners. The 6 pin DIN 
plug was fitted to the left hand bottom corner of 
the fibre board. | later found that the keyboard 
had been fitted with a small additional circuit 
board containing 2 transistors and a small 
number of resistors etc between the connecting 
cable and the circuit board. 
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This kit was fitted to my QL and! found that | had 
a very stable system which accepted further 
nardware updates without a flicker After 9 years 


of faultless use | started to get occasional 
missed keystrokes and additional characters. 

| met Tony Firshman at a computer fair and dis- 
cussed these problems with him. He suggested 
cleaning the keyboard contacts. This | did, curing 
the missed keystrokes, but not the additional 
characters. Over the following months further 
faults developed in my QL, mainly faulty ram 
chips (old age?) which resulted in the destruction 
of my hard disk. | again contacted Tony through 
TF Services asking if my computer could be 
repaired. He agreed to try but after 1 or 2 
attempts the keyboard still gave trouble. At this 
point | decided to eliminate the problem by asking 
him to fit a superHermes. This was done and the 
various pieces of redudant hardware were 
returned with my repaired QL. 

| have compared the photographs with my Schon 
interface and it matches exactly in all respects. 
From memory, | recall that an earlier version of 
this interface using the existing keyboard gave 
trouble with key bounce, etc and was given bad 
reviews. A later review of the PS/2 version said 
that it had cured all the earlier version's faults 
(hence my purchase). The bad reviews may have 
affected sales as it took TK Computerware 
about 7 months to obtain my kit. 

| hope the above ramblings will answer John 
Rish's query and prove useful. 


Ralf RekGndt also told us - with surprise - that it 
iS a Sch6n interface. 


Peter Marsh writes: 

The keyboard interface on page 7 was sold 
under the name of SCHON’ back in 1987 WITH 
KEYBOARD for £99.95 . 
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About Printing Accented 


Characters 


lan Pizer 


In order to see accented cha- 
racters on your QDOS screen 
you need to have a list of the 
combination of keys to get 
what you want. Below is my list. 
(consult Jan Jones Handbook 
page 184 or the original QL 
USERS GUIDE, or just try the 
combinations shown below). 


ASCIL HEX CHAR KEYS 
130 82 4 CS2 
i4i 8D a C- 
i140 8C 4 & 
142 BE 4a C. 
128 80 4 C esc 
144 90 6 CO 
131 838 6 cH 
145 91 6 Cl 
143 8F 6 C/ 

i cmd 
148 94 | C4 = 
147. 93 Of C3 
149 95 j C5 
146 92 | C2 z 
151 97° 6 Cr a 
150 96 6 bo: 
152 98 6 C8 
132 84 oO CS4 
154 SA ou CS: 
153 99 ou C9 
155 OB a Gi 
35 87 u S 
1386 88 c¢ CS9 
137 89 Af CSO 
163 AS o£ GSC 
172 AC a4 CSL 
77 ~Bi T CSQ 
176 BO 424 CSP 


But these combinations may 
not suit your printer so you 
need to load a TRAnslate pro- 
gram which translates the 
codes necessary for your 
printer 
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| use a BASIC program written 
by Jan Bredenbeek of Holland 
which will do this for you pro- 
vided you know which codes 
need to be translated. This pro- 
gram was once available on a 
Bulletin Board but you can find 
it on disk UGO2 of the QUANTA 
Library. {in extremis ask me for 
a COpy: 
ianpizer@compuserve.com). 


This program allows you to use 
1, 2, or 3 codes in the transla- 
tion. For example: e backspace 
* would give you e with a cir- 
cumflex. (101 8 94). | use this 
translate method when | print 
from QD but if TRAnslate is 
operative when | use Text87 | 
must print to PARD to avoid the 
translation which is not needed 
(thanks to Roy Wood). 
Once you have run the BASIC 
program it makes a TRA pro- 
gram for you whose size is 
263 bytes. To make the transla- 
tion operative you do 

a=alchp(263) 

lbytes wini_TRA,a 

TRA a 


You cannot do it with LRESPR. 
To make inoperative do TRA 0. 
| have recently heard of a pro- 
gram Called Clavier (French for 
Keyboard) which may be even 
more flexible than TRA. It can 
be downloaded from Jochen 
Merz’s BB. 

In QUANTA March 2000, Page 
34, Dr Teply has managed to 
have about 30 accented cha- 
racters for the Czech language 
and some with an inverted cir- 
cumflex (the character above 6 
on keyboard that | call circum- 
flex but it probably has a pro- 
per name!}, which the method 
above cannot do. 


Foreign character sets are 
an issue which matter to 
quite a lot of QL Today 
|readers. Thanks to lan for 
| giving us an example which | 
works on QDOS and 
SMSQ/E. 
We also get requests about 
other language options for | 
SMSQ/E. As most of you] 
know, English, French and 
German keyboard tables, | 
translation tables and cha-| 
racter sets are built into] 
SMSQ/E. It is possible to | 
choose between the langua-: | 
ges by selecting them with] 
LANG_USE, KBD_TABLE or | 
i TRA, followed by — the} 
country code (GB, FD) or the | 
| phone prefix for that country | 
(44, 33, 49). This will select 
|the error messages, key-| 
board layouts and_ printer | 
translations of the given} 
country, 
It is possible to extend this | 
scheme by adding new mo- 
dules to SMSQ/E. You can, 
therefore, add a module to 
SMSQ/E which allows you to | 
select Denish keyboard by 
typing KBD_ TABLE DK. 

However before this is pos- 
sible, somebody needs to 
prepare the right keyboard | 
tables and error messages. | 
This should be done by 
somebody who has a minor | 
knowledge of machine code | 
(it is mainly changing values | 
in a table) and who knows | 
the keyboard table very well. | 
We can't do it - | have no | 
concept of other languages | 
than English or German, and | 
some keyboards have fancy | 
features like non-spacing | 
characters (for accents). 
| If you would like to prepare a | 
table and the messages, 
please contact us! (This invita: | 
| ion goes to everybody who | 
uses a keyboard different to | 
| English, French and German). | 
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Programming in Assembler - Part 9 


Norman Dunbar 


You can relax this time - this part is fairly short. 


Maths Stack 

The maths stack is where all internal mathematical calculations of floating point variables are done. It is 
also used to allow parameters passed to machine code procedures and functions to be ‘collected’ 
from the user and passed to the registers etc for use by the procedure or function. 


The maths stack is simply an area of memory which can be used for all these fancy calculations, 
parameter handling etc. There is nothing (much) special about it and it is ALWAYS addressed internally 
using register Ai (relative to A6 - but you knew that didn’t you?) 


One of the first things | learned when writing extensions to SuperBasic was that on entry to a function 
or procedure, the Al register is set to a value corresponding to the top of the maths stack. This is a 
MYTH and is not correct. 


The value in register Al can be anything on entry to a machine code function or procedure. | have done 
a lot of investigating (thanks to QMON2) and come up with the following rules: 


lf you want a suitable value in Al for the top of the maths stack, then either fetch some parameters, or 
load it from BV_RIP 


This means that if a function wants to return a value - which functions usually do - and the function has 
no parameters then you must load Al from BV_RIP{A6) before calling the BV_CHRIX vector to reserve 
space. As | found out to my cost, not setting Al is a good way to trash the system! 


lf your function does have parameters, then AFTER they have been fetched, Al is set ok, up until that 
time, it is not and has the following possible values: 


Ai Negative 
lf Al is a negative number, then your function has been called as part of an expression such as: 


PRINT 10 * MY_FUNCTION(p1, p2, p3 ....) 


The number in Ai is the number of bytes that have already been used on the maths stack for the ‘10’ in 
this case. This will be -6 as the 10 will be stored as a floating point number. 


Ai Zero 

lf the number in Ail is zero, then your function has been called thus: 
PRINT MY_FUNCTION(p1, p2, p3 ....) or 
PRINT MY_FUNCTION(p1, p2, p3 ....) + 10 


and no bytes have been used on the maths stack yet. 


Ai Positive 
lf Al is greater than zero then this implies that there are that many bytes available on the maths stack 
and calling bv_chrix to allocate stack space will not move the maths stack around in memory, 


NOTE: | have NEVER seen this documented and it has been discovered by me during long debugging 
sessions. Now that SMSQ is here, the above information may no longer be valid. The ONLY thing to 
remember is that on entry to a procedure or function, Ai DOES NOT hold a suitable value for the top of 
the maths stack as stated in various documents. 
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So that is the real situation and not as specified in the documentation. | took ages to debugg one 
simple function | wrote, which had no parameters and required some space on the maths stack for its 
result. Take a look at the code in the colour functions (green, red etc) we wrote back at the start of this 
article and you will see the following code: 


return_d7 move.l1 bv_rip(a6),a1  ; Because we had no parameters passed 
moveq #2,d1 3 Size of stack space required 
move.w bv_chrix,a2 3; Routine to allocate maths stack space 
jsr (a2) ; Go get some space NO ERRORS OCCUR ! 


As you Can now see, we load Ai from BV_RIP because none of the functions had any parameters 
passed. Had that one line of code been missed out, your QL would have crashed. Try it if you like! 


Values on the maths stack must be stored at even addresses. For integers, long integers and floating 
point values, this is not a problem. Strings, on the other hand, must be set up correctly with the word 
defining the size on an even address and the bytes of the string following. Odd length strings should 
have an extra padding byte to keep the Al maths stack pointer even. 


If you read back to the section above entitled ‘Keeping things even’ then you will see how to do this. If 
you are returning a string from a function, you will need to reserve space for the string, its word count 
and a possible spare byte for padding. Refer to the explanation above and you will see why the 
following code ‘just works’: 


Assume the string to return is at (AO) 
+2 for size word + 1 for padding if reqd 
Make even - removes padding if not reqd 
Routine to allocate maths stack space 

Go get some space NO ERRORS OCCUR ! 


ret_string move.w (a0),d1 
addq.w #3,d1 
belr #0,d1 
move.W bv_chrix,a2 
jsr (a2) 


Neon Neo Wo we fee 


Of course, | am assuming that Ai holds a suitable value. The code above will request an even amount 
of space for a string result. First we fetch the length into Di - this is the number of characters in the 
string only. 


We then add 3 to D1. This is 2 for the word count and one for a possible padding byte. By clearing bit 
zero of Di we force the number to be even and can then carry on with the request for space etc. Easy 
Stuff this! 


Retruning Values from Functions 

When returning values on the maths stack you must be very careful. When a function exits there must 
be a value on the top of the maths stack the pointer to this value needs to be stored in BV_RIP(A6) and 
D4 has to have a values in it which defines the returned parameter type. 


ib | String | 
2 | Floating point | 
3 | Word integer 


Notice anything missing? Although we are allowed to fetch long integers as parameters, we are not 
allowed to return them. This is a problem and the usual fix is to convert a long integer to a floating point 
and return that instead. This will be covered in another thrilling episode! 


QL loday 37 


Channel Tables 

in our procedure PSI_CLS, we use a channel number in SuperBasic. In assembler, this is no use to us as 
all internal operations that require a channel (CLS, PAPER etc) require a channel id which is a 32 bit long 
number which bears no resemblance (or only coincidentally) to a SuperBasic channel number 


In QDOS there is a channel table - for the entire system, and there is the SuperBasic channel table 
which is used to convert channel numbers into channel ids which is what we require. SuperBasic keeps 
us away from nasty things like internal representations - assembler does not. 


The routine we used above, channel_id, 's all that is required to convert a channel number to a channel 
id. It looks at the SuperBasic channel table and for each channel that has been opened (even if it is now 
closed) there will be an entry in the channel table. Each entry is $28 bytes long (40 bytes) and has the 
following format: 


fame enn nnn nn nnn nn ne nn nn nn nn nn en en eee + 
Offset | Size | Purpose 
$00 | Long | QDOS internal channel id | 
$04 6 bytes | Graphics cursor X position (Floating Point format) 
| $0A | 6 bytes | Graphics cursor Y position (Floating Point format) 
$10 6 bytes | Turtle angle (Floating Point format) 
| $16 Byte | Pen status (0 = up or 1 = down) | 
$20 | Word Character position on line for PRINT and INPUT ete 
$22 Word Width of the channel. Set by WIDTH command in SuperBasic | 
| | | but defaults to 80 when OPEN is called. 
$24 Long Spare - currently unused 
Ne ee ee os + 


When a channel is opened in SuperBasic, an entry is created (or reused) in this table. At startup 
channels #0, #1, and #2 are pre-created and that is all. If you now open 44, anew entry will be created 
for it. If you open channel #10, then blank entries are created for all the ‘in-between’ channels (5 to 9) 
and entry 10 is then created and initialised on top. 


A channel that has never been opened can therefore still have an entry in this table - channels 5 to 9 in 
the above example. All of these use memory so it is advisable to start with 3 and work upwards 
opening channels as you go, rather than opeing #100 or something similar which needlessly wastes 40 
bytes of memory for each unused channel. 


A channel that is closed, or has never been opened, has a QDOS channel id which is negative. 


In the Basic variables area in QDOS (to be covered in a later issue - and by the way, | refer to the 
variables that hold information about SuperBasic, and not variables you create in SuperBasic !) 
BV_CHBAS holds the offset from A6 to the first entry in the table (ie channel #0) and BV_CHP holds 
the offset from A6 to the first byte AFTER the last entry in the channel table. Don't forget that these are 
offsets and that everything in SuperBasic is relative to A6 - simply because by doing this the base 
address for the job (SuperBasic is just another job in the machine) is held in A6. If everything else is 
stored as an offset then moving the job in memory is simple as only the A6 register has to be updated. 


Take a look at the code for channel_id again and note how we are using addresses that are relative to 
A6. Make sure that you understand because all fiddling in the bowels of SuperBasic requires that you 
understand relative addressing. 

Most of the time you will only be interested in the conversion from SuperBasic channel number to 
QDOS channel id. 
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Homework 

As an exercise, why not add a new procedure called PSI to the code for PSI_CLS. This new procedure 
will carry out all the same work as PSI_CLS but it will not do the CLS part of it. This will be useful when 
you want to set the colours for a window but not clear it. | wil NOT be giving the answers out next 


time, but here are a few hints: 


- update the definition table with details of the new procedure. 
- in the proc’s code, set D6.B to zero for PSI and 1 for PSI_CLS. Do this as the first instruction in both 


procedures. 


- In the PSI procedure, simply set D6 and jump fo the code in PSI_CLS. 
- Just before doing the actual CLS part of PSI_CLS, check the value in D6.B and if zero, don't do the 


CLS simply BRA.S to error_exit instead. 


in the definition block. 


Allin all, | think this can be done in about 10 extra lines of code, maybe less, not counting the extra lines 


BEWARE: Adding even a few lines of code can sometimes cause any ‘short’ branches to go out of limit 


and this will cause errors in the assembly, If this happens, simply find the ones in error and remove the 


Ss’ from the ‘bsr’ or ‘bra’ instructions. 


Next Issue 


That's it for this issue. In the next article we will be exploring the depths of QLIdis again with a 
pseudo-code run through of exactly how we are going to decode all those instruction families - no 


typing you'll be glad to hear See you then. 


The EPSON Saga... 


Jochen Merz 


Readers of QL Today will know that | always used 
to recommend EPSON printers - they always 
were very flexible, and compatible with existing 
QL programs. Unfortunately, the range of printers 
which supported the required ESC/P2_ is 
permanently shrinking. The only available model 
is the Stylus Color 900 - a high end printer All 
lower models come with the very cut-down 
version of this printer operating system, called 
ESC/P Raster It seems that EPSON saves a few 
pence by using a smaller EPROM and, saving 
programming work by providing just a “dumb 
dump’ device without “intelligence’. 

Pity for us, but maybe there's a way out of this. All 
one needs to know is: what is ESC/P Raster? 
Very few instructions only, which | will list in the 
following article. | have not tested them myself, | 
hope, somebody Is going to try it, and to provide 
the QL scene with a method of device driver 
emulation to convert “ordinary” output into raster 
graphics which is understood by all ESC/P Raster 
printers - as a result all QLers would benefit from 
the fact that virtually every EPSON colour printer 
could be used again for printing. 
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Please note that only the following commands 
should be used - they must not be mixed with 
any ESC/P2 commands. 


The whole raster graphics print is based on the 
command ESC . (dot), hex $1B $2E. This is 
supported by all ESC/P2 printers too, so you can 
try it even if you do not have a ESC/P Raster 
“only” printer The definition of the ESC . command 
can be found in any EPSON documentation 
(ESC/P Reference Manual, for example). It is quite 
complex, as it allows raw data as well as 
compressed raster (RLE, TIFF and Delta Row). To 
make sure it works on all printers, use 
uncompressed data. If you write a driver allow 
the specification of the printer model so that the 
driver can decide, depending on the printer 
whether to use compression or not. To give you 
an idea about the complexity: some more recent 
cheaper printers do not support compression 
(e.g. the Color 400), whereas older printers (Color 
ll, quite old) did. Some do not support higher 
raster bands with compression methods, some 
dont if Microweave is on. Better use 
uncompressed, even if it takes longer RLE 
compression, however seems to be OK on all 
printers. If you try it on dot matrix printers, avoid 
720dpi, best start with 180dpi and then try 
360dpi. 
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Before your print raster graphics, you must "Enter 
raster graphics mode’ (all hex values): 


1B 28 47 01 00 01 


Inside this mode, you cannot print text. You 
should not mix text and graphics printing on tthe 
same page. Only a very limited range of printer 
codes Is available, which are: 

LF, FF, CR, ESCEM, ESC@, ESC., ESC (i, ESC (c, 
ESC (C, ESC (V, ESC (v, ESC@, ESC $, ESCr, ESC 
U, ESC +, ESC (U 


To exit this graphics mode, send 
1B 64 


Now, as you've entered the raster graphics mode, 
back to printing with ESC . : 
The ‘Print Raster Graphic’ command is (all hex) 


1B 2Ecvhmn n, dad, d... d, 


where 

e is the print mode: 
0 = uncompressed raster 
1 = RLE compressed raster 
2 = TIFF compressed raster 
3 = Delta Row compressed raster 

v is the print density in the vertical direction, 
v/3600 dpi. Possible values are 5, 10, 20 

h is the print density in the horizontal direction, 
v/3600 dpi. Possible values are 5, 10, 20. 

m iS the raster band height in dots. 
Possible values are 1, 8, 24. 
The values depend highly on the printer model, 
resolution used and other settings (e.g. micro- 
weave, Compression). 

n,+256* n, iS the number of dots in the horizontal 
direction. 

d, d,.. d, IS the raster data, row by row left to 
right. 


Another {not quite as important) command is 
"Select Dot Size’. Again, a feature not supported 
by every printer - and even the same Settings are 
different in their result (at least the wording is 
different). The command is (all hex): 


1B 28 65 02 00 00 n2 


Where 

n2 defines the dot size: 
0 = default dot size 
{ = small (smaller micro} dot, depending on 
model 
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2 = standard (normal) dot size, depending on 
model 

3 = double dot size (supported only by more 
recent models). 


For the Stylus 600, 0 is the same, for the rest add 
1. 1 itself is not implemented (seems to me like a 
bug, or maybe EPSON wants to be difficult). 
This command is very printer model dependent, 
So better not use it unless you know the printer It 
has to be issued before printing raster graphics, 
prior to paper feeding and should not be 
changed in the middle of the page. 


EPSON recommends the following order of 
commands: 


1. Initialisation of the printer: 
Initialize printer @ 
Select graphics mode (G 
Set unit ESC ( U 
Set page length es 
Set page format (¢ 


2. Printing method control: 
Select uni-direction mode ESC U 
Select MicroWeave print mode ESC ( I 
Select monochrome/color ESC ( K 
Select dot size ESC ( e 
Select print speed ESC (8 


3. Then for every raster line 
Set vertical position ESC 
ESC ( v 
Then for every color per raster line 


Select color ESC r 
Set horizontal print position ESC \ or 
ESC $ OF 
Rpoe.G \ 
Print raster data ESC . 
4 New page FF 
5. Terminate printing: ESC @ 


The command to select MicroWeave is also 
printer-model dependent, and so is the command 
to select monochrome/color printing. The latter 
can be used to select higher performance 
monochrome mode, but is limited to more recent 
printers only. 

| have no idea what these commands do on 
printers which do not support them - whether 
they are just ignored are whether the printer will 
print garbage. Any feedback would be helpful. 
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Worldwide Membership is by subscription 
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Regional Sub-Groups. One near you? 
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The London QL Show - A Review 


By Darren D. Branagh 


Saturday the 2nd September 
was the date for the latest QL 
Show, and the first in the Grea- 
ter London area for quite a few 
years. It was held at a new 
venue - a hall not too far from 
Ken Brickwoods house, who 
helped organise the event, 


along with Malcolm Cadman 
and various other members of 
the London QL Group. 


| for one was looking forward 
to it, as | always remember how 
popular and busy the London 
shows of old were. The first QL 
Show | ever attended was at 
the old venue near Ladbroke 
Grove, some 6 or 7 years ago, 
and | remember how busy it 
was. 

Sadly, this QL show was to be 
alot quieter They were several 
reasons put forward for this - 
the main ones being the fact it 
was held on a Saturday when 
most QL shows are on a 
Sunday, the fact that England 
were playing cricket at the 
Oval (just down the road from 
the venue}, and the fact that 
maybe many people were 
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saving up for the forthcoming 
QL2000 event - all of which 
didn’t help. Having said that, al- 
though numbers were scarce, 
a lot of interesting things hap- 
pened. 

The first stand on entering the 
main entrance of the hall was 
the QUANTA desk, ably man- 
ned by Bill Newell and Basil Lee. 
They were selling their range 
of Sweatshirts and other 
hardware and software items 
and taking subscriptions, and 
the QUANTA Library was 
available to Members. | 
discussed the forthcoming 
QUANTA CD-ROM _ Disk, 
which | am producing with a 
few people and interest was 
very encouraging - the disk 
will contain the — entire 
QUANTA QL Library — of 
programs all in a_ single 
QXLWIN file for use with 
QPC, Q-Emulator and the 
QXL, or any system that can 
read them - over 100Mb of 
files in total. This should be 
available from the QUANTA 
desk at the QL2000 show 
for a modest fee of about £5 
each. 

Next to QUANTA was Roy 
Wood of Q-Branch, selling his 
vast range of pointer driven 
programs, and also clearing a 
lot of ca- 
bles and 

small 
hardware 
pieces as 
Roy has 
recently 
closed his 
Shop - the 
Bank Volt, 
near 

where he 
lived, to 
concen: 


trate on other matters. Lots of 
bargains could be had, and as 
ever Roy had a crowd around 
him for much of the day. | at 
least got a laugh when Roy 
was reduced to buying a copy 
of MS-DOS from me in order to 
do an install of QPC for a custo- 
merll Roy is currently testing 
the beta drivers of the 16-Bit 
colour version of QPC2, and 
said that is was coming along 
well and hoped to release them 
very soon indeed. This coupled 
with the fact that the first ever 
QL emails have already been 
sent by Jon Dent is very en- 
couraging, and we will all pro- 
bably be using our QL’s for 
email and web access by year 
end at the latest. 

Star of the Show award though 
goes to Tony Firshman on the 
TF Services stand, who actu- 
ally premiered a brand new 
product at the London Show - 
called a compswitch. This is an 
ingenious little device that 
closely resembles a 4-way trai- 
ling socket that many of us are 
familiar with - indeed you will 
find one in virtually all QL’ers 
homes. However the comp- 
switch has some very clever 
additional features. 
Compswitch is designed to 
switch on/off all computer peri- 
pherals automatically with a 
computer, when it is plugged 
into one of the sockets marked 
“computer”. It will mimic exactly 
the "power-out’ connector you 
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may remember on IBM AT com- 
puters. This connector was on 
early IBM ATX systems, but is 
now generally not available. 
The Compswitch has one 
socket marked aecomputere, 
nearest the fuse, and you sim- 
ply plug a computer into this 
socket - such as your PC, and 
any other peripherals or devi- 
ces into the other three 
sockets which are all marked 
‘switched’. Now you can switch 
off/on your Scanner, Speakers, 
Modem, Monitor even your 
Hi-Fi and Printer via the com- 
puter switch! As Supplied, the 
Compswitch has four standard 
UK 3 pin sockets, but Tony told 
me adaptors can be used in 
these if needed for other use 
and the maximum power on 
the ‘computer’ socket is 500 
Watts, with at least 10 Watts 
beings required to switch on 
the ‘Switched’ sockets. A very 
clever device indeed, and one 
that | am sure will sell well, as 
indeed it did - | know one Qler 
who went home with several of 
them! 

| was next to Tony, and al- 
though failed to match the 
uniqueness of the Compswitch, 
had quite a lot of items for Sale. 
The newest revisions of the 
Dilwyns Jones QL Collection 
were available on Disk and 
CD-ROM, as was the new 
LineDesign Clipart CD-ROM 
containing over 5,000 pieces of 
Clipart. | had a demo beta 
version of the new Spectrum 
Emulator CD for the QL. with 
thousands of ZX Spectrum 
games and utilities on it, 
including the ZeXcel Emulator 
by Ergon. Dilwyn couldn't make 
the Show as he was preparing 
for his wedding a fortnight later 
but was however beavering 
away on several new CD's for 
launch at the QL2000 Show, 
including the Religion Texts CD, 
which will contain over 150Mb 
of religious text files from all 
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the various religions of the 
world including everything from 
the King James Bible, to the 
Holy Koran, to the teachings of 
Buddha and Confucius, and 
even a Bible Dictionary and 
Some Christian Jokes used by 
Vicars and Priests etc. in their 
Sermons. Dilwyn also struck on 
an idea to do a CD containing 
the full QL Club International 
Newsletters, from beginning to 
end. | also had a lot of novelty 
mice (}) which sold well 
throughout the day, and a small 
range of QL hardware and 
second user bits and bobs. 
At the top of the room, just in 
front of the stage area was 
Jochen Merz of JMS. He as 
ever had an ever growing 
queue in 
front of 
his stand 
with a lot 
of people 
getting 
upgrades 
to his 
vast 
range of 
software. 
Jochen 
was 
demoing 
the latest 
version of QPC at his stand, 
and although not quite ready 
for public release at the time, it 
was showing a lot of promise. 
QPC can now be used in a 
Window under Windows (yes, 
confusing isn’t it?) and can 
therefore be moved around the 
screen on the Windows 
desktop, without the need to 
take over the entire screen 
unless you want it to. The 
colour drivers are due to be 
implemented soon too, and will 
probably be available at the 
QL2000 Show or by the time 
you read this. Jochen was also 
Selling the new ‘The Wall’ 
game by Wolfgang Lenerz, as 
reviewed last Issue and conti 


nued to amaze me by selling 
blank recordable CD-R disks 
for less than 5.00 for a box of 
ten - they cost three times this 
much at my local discount 
computer shop!! His DD and HD 
disks were similarly very cheap 
indeed. 

Of the traders, last but not least 
was Geoff Wicks of Just 
Words! Who was next to 
Jochen at the front of the 
house. As ever he was selling 
his range of programs for the 
word sleuth and Word proces- 
sor user alike, and Geoff spent 
much of his time bent down in 
front of his Laptop giving de- 
mos of his products. 

Sadly missing from the traders 
were Rich Mellor of RWAP 


Software, who is still very ill and 
will unfortunately miss QL2000 
also (Roy Wood is_ bringing 
some of his wares to QL2000 
on Rich's behalf, and is looking 
for someone to maybe help 
out in the collection of stuff 
from Rich, if anyone can help, 
contact Roy) Bill Richardson of 
EEC was also not at the show 
as he too is also recovering 
from an Angioplasty operation 
a while ago - hopefully he will 
be back on top by QL2000. 

Ken Brickwood, Malcolm Cad- 
man, and other members of the 
London Group manned the Kit- 
chens for the day, and provided 
a range of Sandwiches, Rolls, 
Cakes and Biscuits all at very 
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cheap prices, including the 
usual tea and coffee (Including 
some very good Organic 
sauces - thanks Malcolm!) 

They also stretched them- 
selves to looking after the 
bring and buy stall, containing 
items for sale from the collec- 
tions of the London members, 
including items that once be- 
longed to the Late Cyril Phillips, 
who sadly passed away a 
Short while ago, and had been 
donated by his wife | think. Ken 


Brickwood brought along a lot 
of items from his own house 
too, and sold a lot bits and 
bobs - he had at least a half 
dozen Digital Diaries for sale - 
is this man the most organised 
on earth? 

Towards the mid afternoon, a 
former QL user called David 


O'Connor brought in several 
large boxes of QL related gear 
in an attempt to sell it all off as 
he hadn't used it at all in years. 
QL’ers gathered like vultures 
from every corner of the hall in 
a matter of seconds at the 
prospect of a potential bargain. 
There was a wealth of older 
QL software and Hardware 
there, including loads of Micro- 
drive based stuff and a lot of 
people left the area with large 
smiles on their faces, as most 
were 

yours for 
a couple 
of quid. 
These in- 
cluded a 
new young 
QL user, 
called Tar- 
quin Mills, 
who bought 
a complete 
QL system 
from David 
very cheaply. Nice to know the 
QL can still attract new faces at 
this stage of the game - very 
encouraging. 

Even | went home happy, as | 
managed to find a QJUMP 
QEPIll Eprom Programmer inter- 
face among Davids stuff for 
only a tenner - it even still had 


New E-Mail Addresses 


Thanks to Bruce, the domain qltoday.com can be used for QL Today. He also introduced various, very 


useful E-Mail addresses 


Today team with the following E-Mail addresses: 


bruce.nicholls@qltoday.com 
dilwyn.jones@qltoday.com 
jochen.merz@qltoday.com 
roy.wood@altoday.com 


the original VISA payment slip 
inside the box for 139.95... :-}) 
As | was staying with Malcolm 
Cadman in his flat in Deptford, | 
stayed back and helped tidy up 
after the Show, and we then 
went around the corner to Ken 
Brickwood’s house for a cup- 
pa. While the Tea brewed, | be- 
gan playing with Ken's Macin- 
tosh Powerbook, and under 
the ‘Virtual PC’ program | ma- 
naged to get QPC running ona 
Mac!! Basically what we had in 
front of us was an Apple Mac 
emulating a PC which in turn 
was emulating a QL - and it 
worked. It even ran at a usable 
speed (a little slow, but usable 
nonetheless) and we were able 
to view the QUANTA Libguide 
disk on it easily. 

An interesting way to end a QL 
Show, and it just goes to show 
the platforms on which a 
QL/QDOS/SMSQ_ environment 
is now available. With the Lon- 
don Show over we all agreed 
to hold another next year as it 
had been much too long since 
the last one. Thanks to the 
London Group for organising it, 
particularly to Ken and Mal- 
colm. Then our thoughts 
turned towards QL2000 
hoping it will be everything we 
all hoped it will be - stay tuned 
for the answers... 


- very easily recogniseable! You can reach individual members of the QL 


lf you want to contact the editors (in their function of being one of the editors), please use 


editor@altoday.com 


which will reach both Dilwyn and Bruce. 
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The Editor Gets Hitched... 


By Darren D. Branagh 


Saturday the 16th of September was a big day for the Editor of QL Today, one Dilwyn Lloyd Jones. He 
decided to tie the knot with his girlfriend, Christine. 

Yours Truly was best man, and! even manged to remember the rings The entire day (thankfully) went 
without a hitch, and Dilwyn now has a new first love in his life (instead of his QL). The venue was the 
Registry office in Bangor near where Dilwyn lives, followed by photos in the beautiful grounds of 
Bangor Cathederal. The reception was held at the lovely Eryl Mor Hotel in Bangor, which had a beautiful 
Sea view overlooking the pier and puffin Island in the distance. A really delicious buffet lunch followed 
conprising seafood, samosas, drumsticks and ribs and steaks followed by some of the most wonderful 
desserts I've ever tasted (I tried most of them!) 

Allin all a great day, and one I'm sure Dilwyn and Chris — 8 

will remember - especially the speeches! Dil and Chris in the grounds of Bangor Cathedra 


|Dilwyn and his new wife, Chris, in a gazebo on Bangor pier 


\ $ 
i 


SSS So aut oan 
ng car - don't worry, there is a QL in the back se, 


ity: 


Yip 


iiwyn and his son, Iwan, 
playing at the wedding - iiwyn and Chris outside their | 


first a digger next a QL..?) hotel room after the wedding 
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Inside GoldFire - Part 2 


"Nasia" 


1.2.8 Comparison between GoldFire and original QL bus specification 


Several lines have changed names and in some cases functions. Great care has been taken to keep 
the modifications completely compatible with every known existing peripheral that works with a Gold 
Card or Super Gold Card. In fact, even some peripherals that do not, may work with the GoldFire. In 
some cases lines have changed function. This type of change was used for lines that were either 
unused, or have outlived their usefulness with the advent of previous well accepted peripherals. With all 
the changes, it is expected that only some very unusual and possibly homebrew add-ons will have 
problems. 


Here is a comprehensive signal name translation table: 
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oS SStels4+SS-SSSSSop SSS passes pS SS Sess SS SSa nse SSS SSS SSS SSSsas SSS SSSeSsec SSS Say 
| QL name | GF name | C | Comment 
foasEsssaapssssaassspesspessssassssssssassssessssssssssassssassesssssasssassss+ 
DO. .D7 |Dx, Ax, BSx| Y | Compatible for 8-bit access, new features 
| AQ. .A19 Dx, Ax | Y | Compatible for 8-bit access, new features 
ASL -WTRQ 2? | Not used by existing QL peripherals 
DSL -NTRQ Y | New features | 
| RDWL -WR | Y | New features 
| DTACKL | -TACK Y | Compatible for 8-bit access, new features 
BGL -WDATA N | Remove 68008 CPU when GF w. QL motherboard is used 
BRL -ATRQ N | Remove 68008 CPU when GF w. QL motherboard is used 
RESETCPUL| -RESET | Y 
CLKCPU | CLK |. °¥ 
R,G,B | reserved| ? | Not used by existing QL peripherals 
CSYNCL -RFSH C | Compatible for (Super) Gold Card use 
| VSYNCH POLL C | Compatible as poll interrupt source 
| VPAL -VPA C | Depends on motherboard, see below 
| E A23,D23 | C | Redefined as address line, 6800 chips not supported 
FC2 | A22,D22 | C | Depends on CPU replacement used, see below 
FCL A21,D21 | C | Depends on CPU replacement used, see below 
FCO | A20,D20 | C | Normally not used on QLs 
| ROMOEH ROMOE | Y | Depends on motherboard, should be phased out 
| DBGL reserved| ? | Not used on QL existing peripherals 
DSMCL | DDEC8 Y | 
| IPLIL IPL1 | c | IPC cannot cause int. level 5 and 7 on GoldFire 
IPLOL -HINT N | Subject to interrupt routing on GoldFire 
BERRL -NINT | N | Not used on QL existing peripherals | 
| EXTINTL | -EINT | Y 
SPO..SP3 | GROUND Y | Were originally connected to GND on QL motherboard | 
VIN +5V C | Compatible for modified 5V systems 
vP12 | +12V a 
vM12 -12V a 
GND GROUND | Y 
eR a a ee 
NOTES: 
C Compatibility: 
Y - yes, may also have added features 
N - no (usually lines that were not used by existing peripherals) 
C - conditionally compatible, see comment and additional notes 
? - Unknown, peripherals should not be using these lines anyway 
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OL Cash Trader v3.7 


A well established accounts package for the small to 
medium sized __ business, iaclodine automatic 
generation of profit & loss account, balance sheet, VAT 
retum, reports and analysis for audit trails and 
management decisions. Previously sold for over £100.* 


| QL Pavroll v3.5 


Manage a payroll for a small to medium sized 
business. Handles up to 99 employees easily, 
producing P45s and P60s as well as the payslips on a 
monthly or weekly basis, Calculates tax and national 
insurance and is easy to update to take account of 


current tax year rules. 
O-Help v1.05 NEW VERSION 
NEW! 


O-lndex vi04 

Q-Help: on-screen help for SuperBASIC commands, 
including TK2, Turbo Toolkit, SMSQ/E and PD toolkits. 
Can be used to add help to your own programs - 
simply produce ASCII text for each help page, add an 
index and Q-Help automatically cross-references and 
displays the links. 

The PD toolkits referred to are available for £2. 
Q-Index: The SuperBASIC index supplied with the 
Reference Manual - enter a topic such as ‘screen 


Fv 
£S 


resolution’ and fnd out the commands which relate. 
Sidewriter v1.08 


Produces landscape printouts of Easel/QSpread 


spreadsheets and output from QL Genealogist, as well 
as any other standard text file. You can specify the 
fonts to be used on the page. Works with all EPSON 
compatible printers, from 9 pin dot matrix up to inkjet 
printers. A most useful utility written by Dilwyn Jones 
~ you know it must be easy to use. 


ProForma ESC/P2 Drivers v1.01 


New improved printer drivers, providing up to 720 dpi 
printout in full colour from ah programs written for 
use with ProWesS, such as LineDesign and Paragraph. 
Work on all Epson inkjet printers which support binary 
mode compression (740,850 and 900 models at least). 
1440 dpi to follow. 


OL Genealogist v3.26 


Genealogy For Windows 


Keep track of your family tree! Add individuals, with 
details of their parents and children, watch all of those 
links build up into a formal family tree layout. Text 
files and pictures may also be linked to individuals as 
well as notes and events, making this the perfect way 
to preserve the history of your family for future 
generations, QL version now supports FileInfo I] and 
QMenu as well as keeping details of both the male and 
female trees. PC version is event driven - enter the 
details as they appear in documents and it generates 
the tree from these. Both programs easy to use with 
step by step tutorial. QL data and GEDCOM can be 
transferred to the PC version. 


Flashback SE v2.03 (Upgrade) 


This is the ultimate database program - extremely fast and flexible, easy to 
use, updated to cope with the latest versions of the QL operating system and 
still maintained. A report module is included to allow you to format output in 
any way, including mail-merge. Unfortunately, only available as an upgrade to 
the original version (Original still available from Sector Software). 


SS a4 pe 
So pee A of BES 
SBASIC: SuperBASIC Reference Manual £40 ee 5 Eg E 
< Me 
Updates £6 cach, EEO for 2 (Current Version Rel a) ee $ ie 
: Bose 
Have you ever tried to write a program, but been lostasto [8 8.8. 
the means of performing a certain action? This Reference OS E+ % Sq 
. . Sia, AIO “@ 
Manual provides you with a full description and examples of a ees Sk 
how to use all of the keywords found on a standard QL, plus & ‘5 QE = 2 
the keywords under SMSQ/E, Toolkit If and many different ~oEee Ee 
public domain toolkits. Details of any possible problems are gp SaiGom §& 
provided, together with descriptions of how to use the | » bo G 42 & 
device drivers and how to ensure that your programs are £ a gy pre 
compatible across the range of QL platforms. S, : ‘& g = g ¢ 
rs 
This book is ideal for all QL users and is kept up to date by ‘$2 aft z8% 5 
regular updates. @ 5 Sete 
On LOA 
Orders are currently being taken for the next print run of cee £5 S awe 
this popular tome. <SkSE5 8S 


(Note Price for the book does not inchide postage and 
packing). 


Return To Eden v3.08 
Nemesis MRI v2:03 
The Prawn v2.01 


Horrorday v3.1 
West v2.00 
The Lost Kingdom of Zk v2.0) 


Classic QL adventures, now re-released without any need 
for microdrives. These include mainly text adventures, 
catering for all tastes, from the spoof Prawn, through to a 
Hammer Horror, fighting the bad-guys in the old West and 
battling with robotic hoards and goblins, Return to Eden is a 
massive three disks of adventure, with pictures for each 
location and a captured prince to rescue. With three 
characters to control, each with their own abilities and 
skills, this one should keep you amused for many an 
evening. 

All six adventures are available together for only £25. 


Image D v1.03 


Produce graphical representations of 3D objects - view them 
as wireframe, hidden line and shaded. Perspective and 
magnification can be controlled and views can be saved to 
file for subsequent printing. Multiple objects can be defined 
and positioned relative to each other Simple to use yet 


part of the British 


Yorkshire Map is a much 


produces excellent results. 
QO-Route v1.d8C £25 


The latest version of this popular route finding program. 
Find the quickest route or the shortest route between any 
two places, using roads. A wide range of maps is available 
for this program (see elsewhere in this advert). The program 
is easy and quick to use. You can even add your own places 
and roads to the maps to include local detail. 


RSION £5 


Ever wondered what the stars in the sky looked like 100 
years ago? Or, maybe you want to learn the constellations 
and names of what you see in the sky. This is the program 
for you - generates pictures of the stars for any given place 
or time and provides details on these objects. Includes 
Halley's Comet, the Moon and the Solar System planets. 


countries covered. South and 


your way around the various 
West 


Q-Route (now at v1.08C). Find 


beautiful 


isles. 
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Yorkshire Mup v1.04 


Map v1.00 


D-Day MKU v3.04 £10 
Grey Wolf v1.8 £8 


For the wargaming enthusiast - D-Day is a classic table top wargame, where you 

control either the Allies or the Axis forces and play against either the computer 

or another human player. With the ability to define your own army set ups and a 

Vaya ebY Goyer) stad ani e.8 6 aber | choice of four different scenarios, this should keep you entertained for a while. 

(U le Only) £10 Grey Wolf places you in charge of a submarine - can you sink the enemy 
parvee my shipping whilst avoiding their planes and destroyers?? 


RWAP Software, 4 Anvil Crescent, 
eel Coseley, West Midlands 
WV14 8GA 
TEL: 01902 836888 


BIG Britain Map (needs 2MB) v2.01 


South & Westy 
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Britain-map v1.10 
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Cheques in £sterling 
payable to 'R.Mellor' 
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Certain lines that have ‘compatibility’ status, may 
not be compatible with their original QL bus 
definition when a GoldFire is used, but will still 
retain Compatibility with peripherals, and back- 
planes. This means that they will in general be 
fully backwards compatible but that peripherals 
designed specifically for use with the GoldFire 
may not work with older boards carrying a CPU, 
such as (Super) Gold Card. 


Lines that have a comment that reads ‘depends 
on motherboard’ are not used by the GoldFire, but 
should an older card with a CPU be installed 
instead of the GoldFire, the motherboard or the 
backplane might be required to produce these 
signals correctly for the older card to function. 
This will not be a problem as long as the 
‘motherboard’ is an Aurora or an original QL 
motherboard, and either a Qplane or an Mplane 
backplane is used. 


Lines that have a comment that reads ‘depends 
on CPU replacement used’ are redefined by 
GoldFire in a backwards compatible manner and 
there should be no problems with existing 
peripherals and motherboards. Should mother- 
boards be modified to take advantage of the 
GoldFire signal definition, replacing the GoldFire 
by a Gold Card for such modifications will render 
the system inoperable (no damage will occur), 
because the Gold Card relies on the lines be- 
having according to the original QL bus signal 
definition. 


1.3 Bus protocols 


The GoldFire uses two main bus protocols, the 
narrow transfer protocol, implementing an 8-bit 
non-multiplexed QL-like bus, and the wide transfer 
protocol, implementing a 32-bit multiplexed 
protocol which uses the same electrical signals, 
but will not be seen by standard 8-bit peripherals. 
This enables both types of peripherals to be 
mixed and matched without resorting to new 
backplanes and bus connector definitions. 

For ease of interfacing common 8-bit ROM or 
ROM-like memory to carry driver and OS 
expansion code, a special variation of the narrow 
transfer protocol is also provided, that will be 
transparent to existing 8-bit peripherals, avoiding 
addressing range restrictions that would 
otherwise apply. 


1.3.1 Narrow (8-bit) bus protocols 


The GoldFire uses two types of narrow transfers, 
both based on the same protocol, but with some 
important differences: 


1) The QL compatible narrow transfer protocol. 
This enables the GoldFire to access QL type 
hardware in a completely compatible manner. It 
also offers an extension to the original QL 
specification by being able to contro! the speed 
of the bus. The protocol uses all the usual QL 
signals in their usual manner: 


WRITE READ 
Axx XXXKX KK Xe 
Dxx XXXX7_ KD XXX XMXXKXX___ XXX: : 
-WR 66 ¢ nS | o>: aaa ~] "a is 3 
-NTRQ Mgiee ey \———- 
-TACK ici ae eri seeilie Waa aal  ade 
1 2 3 1.2 3.465 


iagram points: 


Address setup time, data setup time on write cycles 
-TACK dead time during which recognition of a low level is suppressed 


Address hold time, data hold time on write cycles 
Input signal hold time (Data on read, -TACK on any cycle) 


t(1 
A\ = 
45) = min. 1 CPU clock cycle (final spec) 
6) = min. 6ns 
3) = 
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Di 

1.2 

2 

3.4. Input setup time, (Data on read, -TACK on any cycle) 
AS 

4.6 


Timing data: 

t(1.2) = min. 2 CPU clock cycles 

(3, min. 6ns (signal MUST be stable by point 4) (final spec) 
t( 

t(4, 

(2, 


default 11 CPU clock cycles, configurable from 0 to 15 CPU clock cycles 
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1 CPU clock cycle is 1/40000000 seconds = 25ns 
The QL compatible access cycle has 5 phases: 


Phase 1: The GoldFire bus controller outputs 
the address (and data for write cycles) on the 
bus, and sets the -WR line according to the 
direction of transfer, read or write. 

Phase 2: The GoldFire bus controller sets the 
-NTRQ low to indicate that a narrow cycle is 
requested. The -NTRQ signal is compatible 
with the QL bus signal DSL. 

Phase 3: A response is required from the 
peripheral in form of pulling the -TACK signal 
low. This signals that the peripheral has either 
taken the data supplied on a write or has 
supplied data on a read. A special dead time 
feature is built into this phase of the protocol, 
which prevents recognition of the -TACK 
signal being low for a programmable length of 
time. This is done to slow down the bus to 
speeds that can be safely handled by QL 
peripherals, in effect, it provides compatibility, 
The user can choose what the dead time will 
be (and hence limit the maximum speed of the 
bus) by using an appropriate address for the 
access, see ‘2. GoldFire address map specifi 
cation. The -TACK signal behavior is compa- 
tible with the standard QL signal DTACKL for 
QL compatible cycles. 

Phase 4: Once the -TACK signal is recognized 
as being low, the GoldFire bus controller 
latches the data supplied if it was a read cycle. 
Simultaneously, the -NTRQ signal is set to high 
to indicate that the cycle is finished. If it was a 


write cycle, the data bus will still hold the data 
for one CPU clock cycle for peripherals that 
require long data hold times. The address will 
also be held on the address bus for at least 
one CPU clock cycle. 

Phase 5: The peripheral must remove the data 
from the bus on a write cycle, as well as 
deactivate the -TACK signal when the -NTRQ 
signal goes high. 


Timeout feature: 

The QL compatible access cycle also has a 
timeout feature which prevents protocol lock-up if 
no peripheral is present to signal an end of a 
cycle by pulling -TACK low. The cycle will 
terminate automatically once 127 CPU clock 
cycles (approximately 2.5us) have passed from 
setting -NTRQ low. The bus will behave as if the 
-TACK signal was pulled low externally. Data will 
be lost on a write, and on a read, data will be 
indeterminate. 


1) The Auto-terminated narrow transfer protocol. 
This protocol is used to access on-board 
peripherals, and can be used to interface ROM or 
ROM-like memory to the GoldFire for driver and 
OS expansion code storage. The recommended 
use for this is to access byte-wide ROM, EPROM 
or Flash ROM on 32-bit expansion boards, provi- 
ding a cost-effective alternative to using 32-bit 
wide devices. This protocol is very similar to the 
QL compatible one, except that the timing is ge- 
nerated internally to the GoldFire, and a different 
transfer request signal is used to render the cycle 
invisible to both QL type and 32-bit peripherals: 


WRITE READ 

Axx ) 26) nae © ere as 

Dxx 6 0, a ¢ ah 66.9196. 0.0.59.6.6.9 6 TEES 00.0 Gem 

-WR Rx. aT 
ee | } EO) seaaeer as 
$22 A 5 zt 3.465 


iagram points: 


Address setup time, data setup time on write cycles 


-TACK active time 


Address hold time, data hold time on write cycles 


D 

dnd 

2.4 

3.4 Input setup time on read cycles 
45 

4.6 Data hold time for read cycles 


Timing data: 
t(1,2) = min. 2 CPU clock cycles 


t(3,4) = min. 6ns (signal MUST be stable by point 4) (final spec) 
(4,5) = min. 1 CPU clock cycle (final spec} 

t(4,6) = min. 6ns 

i(2,4) = 8 CPU clock cycles, fixed 
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1 CPU clock cycle is 1/40000000 seconds = 25ns 


As can be seen in the diagram, the cycle has 4 

phases: 

Phase 1: The GoldFire bus controller outputs 
the address (and data for write cycles} on the 
bus, and sets the -WR line according to the 
direction of transfer read or write. 

Phase 2: The GoldFire bus controller sets the 
-ATRQ low to indicate that a auto-terminated 
narrow cycle is requested. This means that no 
response other than to take the supplied data 
on a write or Supply data on a read. The cycie 
will terminate automatically after a pre-deter- 


mined period of time, which is 8 clock cycles, 
approximately 190ns. 

Phase 3: The GoldFire bus controller latches 
the data supplied if It was a read cycle. Simul- 
taneously, the -ATRQ signal is set to high to 
indicate that the cycle is finished. If it was a 
write cycle, the data bus will still hold the data 
for one CPU clock cycle for peripherals that 
require long data hold times. The address will 
also be held on the address bus for at least 
one CPU clock cycle. 

Phase 4: The peripheral is required to remove 
ihe data as soon as possible when the -ATRQ 
signal goes high 


About Sprites 


Bruce Nicholls 


What is a sprite? A sprite, ac- 
cording to the EASYPTR docu- 
mentation, is a small picture 
which may be drawn stationary 
or moved around with the 
mouse or cursor keys. Several 
sprite definitions can be linked 
together to form a dynamic 
sprite which can last for about 5 
seconds and a sprife can be up 
to a maximum size of 64*48 
pixels. Sprites can now be 


mode 4 or 8 definitions, 256 
palette mapped colour defini- 
tion, 256 grbgrbgm colour defi- 
nition and native colour (See the 
previous colour article on the 
colour definitions called GD 2). If 
you use any pointer envi 
ronment program the sprites 
are the items shown on screen 
that usually perform a function 
within the program. The most 
obvious ones being the move, 
resize and sleep icons 


mh &l& 


Now there are only three 
programs that | know of which 
allow you to ‘draw’ the sprite 


definition on screen without 
having to resort to hand coding 
the sprite definition. The QPTR 
pointer Toolkit contains a pro- 
gram called EDSPR. this is a 
basic program and can at pre- 
sent only generate QL 8 sprites. 
Easyptr ll contains a sprite 
generator called EASYSPRITE 
which is a true executable pro- 
gram that can only produce QL 
8 sprites at present. But a new 
program from Jerome Grimbert 
is now available called SPRITE 
EDITOR FOR GD2, as you can 
probably guess from the title 
this can generate sprites in all 
their different flavours. 


handled in QL 8, the original 


; 84 448 4 654 
Ql¢ O48 256 BAS 408 Ha 68 
se C7 86 46 Be Hs 

BINES> 
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When you start up the editor 
you are presented with a 
screen similar to the ones 
shown on this page. 

The main area on the left of the 
screen is where you ‘draw’ the 
sprite you wish to define. In the 
top left hand corner of the 
screen are four smaller images 
of the sprite you are currently 
drawing. Why four? well this 
program allows you to copy 
images between the four diffe- 
rent types of sprites as de- 
scribed above. You can design 
a sprite for the native colours 
and then with one button press 
on a conversion icon (48 etc 
situated below the four boxes) 
convert it automatically (colour 
loss accepted) to another 
mode. This is simplicity itself 
and will allow for easy conver- 
sions of old sprites to the new 
formats. lf you are adverse to 
redrawing the sprites this pro- 
gram has two methods for 
reading in old sprites. You can 
give the program a _pic file and 
this will automatically be loaded 
in and converted to a sprite 
The alternative method is 
load a program containing the 
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Sprite you want to use into the 
editor The editor reads the file 
looking for sprite definitions and 
prompts you if you would like it 
to be loaded. 

Once loaded into the program 
various Options are available for 
manipulating the sprite image. 
Colour can be chosen from the 
Standard QL 8 range shown on 
the screen. If you are working 
on 256 colour sprites by 
clicking on the icon looking like 
a monitor you can choose from 
the 256 colour palette which 
presents itself If you are 
working on a Q40_ (native) 
colour sprite clicking on the 
painters palette icon bring up a 
lovely colour wheel showing all 
the possible colours available, 
by moving the pointer around 
within the colour wheel you can 
choose the colour you want to 
use. Once the colour is chosen 
you are given the opportunity 
to decide on the intensity of 
the colour simply by clicking on 
the intensity chart next to the 
colour wheel. When a colour 
has been chosen you can 
easily change it by pressing on 
the + or - symbols above the 


white/red/blue/green icons 
which will change its native 
colour number. 

The sprite image can also be 
manipulated by splitting the 
screen into areas with red and 
black lines which then allow the 
sprite image to be shifted to the 
lefi/right/up and down by using 
the arrow keys. There are 
various other features that | 
haven't had time to explore but 
my first Q40 sprite was 
generated in about an hour of 
use of the program without a 
manual. 

Once you are Satisfied with 
your sprite design you can 
either save the image as a _pic 
file or convert it automatically to 
an assembly file for use by 
QMAC or AS86. 

This program is a delight to use 
and a lot of thought has gone 
into the design to make it as 
easy as possible to create a 
sprite definition, all credit must 
go to Jerome for producing a 
much needed piece of software 
that works so efficiently. 

The zip file containing the 
editor is available from 
www.crosswinds.net/~ grimbert/ 
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A Useful Windows Program 


Norman Dunbar 


| could get seriously hung drawn 
& quartered for this article, but 
here g06S ... 

A long time ago, in a magazine 
far far away, a program was 
printed which was written by 
Dilwyn Jones. {! think | have got 
the time sequence correct here, 
but | am Sure to be informed if | 
have not!) This program was 
written in SuperBasic and 
converted a Quill doc file into a 
plain text file which had all of the 
Quill control codes replaced by 
any text you wanted. Bold on 
could be  feplaced by 
“BOLDON*” and bold off by 
“BOLDOFF” etc, __ leaving 
something like this: 

This is «BOLDON» Bold 
text.<BOLDOFF> This 
is<ITALICON> Italic 

text. <ITALICOFF> 

and so on. This file could then 
be imported into another word 
processor This was useful if 
the new word processor didn't 
allow direct importing of Quill 
files. 

Then Phil Borman took Dil- 
wyn's program and converted 
it into C using 
C68. This was a 
much faster ver- 
sion but did re- 
quire that you 
had to have C68 
in order to make | 
any changes if | 


CCESS._ ASM. 
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Stripper was born. This has 
been available for some time 
on various BBS and most 
recently on Dilwyn’s Web site 
(http://www.soft.net.uk/dj/ 
software/other/striperc.zip) 
This is the QDOS version and 
can strip control codes from 
any Quill document. 

Recently, | was at work having 
my lunch break and! had a few 
zip files on my drive which had 
QDOS software in them. | fan- 
cied a bit of light relief so | 
opened up one of the Quill doc 
files to read in my editor (PFE - 
excellent) but of course all the 
junk from the header was there 
and the lines spanned over the 
width of the screen and when | 
re-formatted them, | got every- 
thing in one big lump. 

Totally fed up of this, | had a 
thought, | have Borland C++ 
Builder on my PC at work as | 
write utilities for our develop- 
ment team to use, and | wrote 
Stripper in C way back then. If | 
could combine those two 


thoughts, then | could have a 


useful (to me anyway) utity that 
| could use when | needed to 
read through a Quill doc file 
which | was at work. Stripper 
for Windows was born. 

| downloaded my own source 
from Dilwyn’s web site - soon 
to be renamed Christine's Web 
Site :o) - and converted it to run 
under Windows and to produce 
a text file. This was fairly easy. 
Then | decided that it would be 
nice to be able to print the Quill 
files as well. Unfortunately, print- 
ing from Windoze is a night- 
mare but the joy of Borland’s 
C++ Builder is that being com- 
ponent based, you can write 
your own components and add 
them to the environment. This | 
had to do anyway as one of 
our work utilities also needed 
some printing abilities - if the 
same piece of code is needed 
in two or more applications, 
thyen it is crying out to be 
‘standardised’ and built into a 
component. So it was. 

Now we have a Quill conver- 
sion program that prints and 
saves the Quill file to a text file. 
So far so good. | tentatively 
mentioned on the QL List if 
anyone else would be interes: 


This file details three file-handling extensicns: the INPUT $ and ANYOPENS: functions, and the 
POS command. The assembly code ts documented in RANDCODE_DOC, and the source file 


for example you 4 fold, including the @ 
: Sipoint in a file withou 
wanted to change 4 simpler than mast DIY: 
BOLDON> — to. | presranners 
i : INPUTS 4 This document explains the cade for these cammands, in the assembler file AULTIS0_ASM, which you : 


just BOLD? etc. 4§ 
Then | came AVINPUTS. is a functiongeon read and customise as you wish, 


along with a. 
need to convert 

a number of Quill 
doc files back — 
into. plain tex 
with all the con 
trol codes re 
moved, and 


he number ‘ofan op : 
MUMIBASIC was written with HiSeft's Devpac, but has been modified to accomadate assemblers that 


da not recognise ‘generic’ instructions, following camments trom AK. Cadman, whe uses Metacamco's 
QL Assembler Development Kit. 


The code starts in the usual way, linking the table of new commands labelled DEFINE into the 
SuperBASIC interpreter. It aiso prints a message in. channel #9 announcing the code dote and versio 


SCRSAVE is the action routine used by SCR_SAVE. Tt checks and copies a single intager poPameter t 
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A UK 4-way trailing socket designed to switch off 
computer peripherals automatically when the com- 
puter is switched off, or (in the case of an ATX 
computer) when it auto-powers down. Compswitch 
has one control socket, and three switched sockets. 


COSE vccvescccccecoaees beedesdeoceeeee suelacesves 


RRA KKK KKK KR RA YY BR RRA RRR KEKE 


_ SuperHermes 


A major hardware upgrade for the QL 
All Hermes features (working serl/2 at 19200, 
independent baud rates/de-bounced keyboard/ 
keyclick) IBM AT kbd I/f // HIGH SPEED RS232 at 
57600// serial mouse port and 2 other RS232 inputs// 
3 VO lines // EEPROM 
Cost (including manual/software) £90 (£92/£93) 
IBM AT UK layout Keyboard £11 (£13/£15) 
Serial mouse £8 (£8.50/£9) 
Capslock/scrollock LED £1 (£1.50/£1.50) 
Keyboard or mouse lead.... ... £3 (£3.50/£3 50) 
High speed serial (ser3) lead £4 (£4.50/£4.50) 


Hermes available for £25 (£26/£27) Working ser1/2 
and independent input, debounced keyboard. 


SuperHermes LITE: All Hermes features (see 
above) + an IBM AT keyboard interface only. 
Cost (incl keyboard lead) £53 (£54/£55) 


——_OL_ REPAIRS _(UK only) _ 


Fixed price for unmodified QLs, excl microdrives. QLs 
tested with Thorn-EMI rig and ROM software. 


£27 incl 6 month guarantee 


N Li nerva 

Hi The ORIGIN 4 I system op erating system up ra de 

| OTHER FEATURES COMMON TO ALL VERSIONS 
DEBUGGED operating system/ autoboot on reset of 
power failure/ Multiple Basic/ faster scheduler- graphics 
(within 10% of lightning) - string handling’ WHEN 
ERROR/ 2nd screen/ TRACE/ non-English keyboard 
drivers/ “warm” fast reset. V1.97 with split OUTPUT 
baud rates (+ Hermes) & built in Multibasic. 


First upgrade free. Otherwise send £3 (+£5 for manual if requd). 
Send disk plus SAE or two IRCs 


MKI...£40 (£41/£43) MIKIL..£65 (£66/£67) 


MINERVA RTC (MKID + battery for 256 bytes ram. 
CRASHPROOF clock & PC bus for interfacing. Can 
autoboot from battery backed ram. Quick start-up. 


Up to 8 mbyte of flash memory for the QL 

A small plug in circuit for the QL’s ROM port (or 
Aurora) giving 2, 4 or 8 mbytes of permanent storage - 
it can be thought of as a portable hard disk on a card, 
and reads at some 2 mbytes per second. 

Think of it - you could fully boot an expanded QL, 
including all drivers/SMSQ etc off RomDisq at hard 
disk speed with only a memory expansion nccded. 


2 mbytes RomDisq £39 (£40/£41) 

4mbytes RomDisq £65(£66/£67) 

8 mbytes RomDisq £98 (£99/£100) 
Aurora adaptor £3 (£3.50/£4) 


MPLANE 


A low profile powered backplane with ROM port | 


A three expansion backplane with ROM port included for 
RomDisq etc. Aurora can be fitted in notebook case and 
powered off single 5V rail - contact QBranch for details. 
Two boards (eg Aurora and Gold Card/Super Gold Card/ 
Goldfire fixed to base. Suitable for Aurora (ROM accessible 
from outside) & QL motherboard in tower case. Specify 
ROM facing IN towards boards, or OUT towards back of 
case. 


COSt .cssecccrsovessercserescscersesssvscsecveesessnee OF (£35/£36) 


Connects to Minerva MKII and any Philips I’C bus 


Power Driver Interface 16 1/0 lines with 12 of these used to 
control 8 current carrying outputs (source and sink capable) 
2 amp (for 8 relays, small motors) £40 (£43/£44) 
4 amp total (for motors ctc) £45 (£48/£50) 
Relays (8 3a 12v 2-way mains relays (needs 2a power 
£25 (£28/£29) 
Parallel Interface Gives 16 input/output lines. Can be 
used wherever logic signals are required £28 (£27/£28) 
Analogue Interface Gives eight & bit analague to 
digital inputs (ADC) and two 8 bit digital to analogue 
outputs (DAC). Used for temp measurements, sound 
sampling (te 5 KHz), x/y plotting £30 (£31/£32) 
Temp probe (-40°C to +125°C) £10 (£10.50/£11) 
Connector for four temp probes £10 (£10.50/£11) 
Data sheets £2 (£2.50/£3) 


OL SPARES—sd 


£24 (£25/£26) 
£3 (£3.50/£4) 
Circuit diagrams Seteoeeers £3 (£3.50/£4) 
68008 cpu or 8049 IPC £8 (£8.50/£9) 
8301/8302 or JM ROM or serial lead £10 (€11.50/£11) 
Power supply (sea mail overseas)..........0000000, £12 (£17/£21) 


Prices include postage and packing (Airmail where applicable). Prices are: UK (Europe /Rest of world). Payment by cheque drawn on bank with UK address, 
debit card/Mastercard/Access/Eurocard/postal order or CASH! (No Eurocheques)}. SAE or IRC for fuil list and detalis 26 Sen'99 
: sep 


29 Longfield Road, TRING, Herts, HP23 4DG 


Tel: 01442-828254 


Fax/BBS: 01442-828255 


tony@firshman.demon.co.uk. _http://www.firshman.demon.co.uk 
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ted. The response was almost 
phenominal and many requests 
were furnished. | even had to 
Start a stripper mailing list to 
make sure that everyone got 
the latest versions. 

There were lots of favourable 
comments received by the 
initial beta testers, | mean, users 
and | suggested that maybe 
MDI (Multiple Document Inter- 
face) would be a good idea - 
again, | was inundated with al- 
most 4 requests for an MDI ver- 
sion! (MDI is Microsoft speak 
for ‘having lots of documents 
open at the same time in one 
application). 

On my next lunch hour | con- 
verted Stripper to MDI format 
and released it to my happy 
users. Then | added more bits 
and pieces - as is the need 
with Windoze programs - and 
released these as well. 

The final version, at the 
moment, has been in use by 
me for some time (almost daily) 
and | have not yet had any 
complaints from my user group 
- so it must be ok! 

This latest version allows a Quill 
doc to be loaded, and saved as 
text. The text has been set to 
80 characters per line with a 
DOS format end of line (CR/LF) 


| For Sale 
| Holborn View QL Hardware Pricelist 
| Supergold card... 80 pounds 


Aurora .. 90 pounds 
Qubide v2.00... 50 pounds 
SMSQ/E Gold _... 20 pounds 


QXL1i 8MB, in Fujitsu 486 DX250 PC with 8mb 
ram, 270mb hard drive, built in PS2 mouse, 
VGA graphics, 115200 serial port, Sernet to 
38400 baud to Q40, QPC, 14° SVGA monitor, 
SMSQ operating system ... 100 pounds 

| SMSQ/E QXL version ... 20 pounds (upgradable 
to GD2 drivers) 
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rather than a QL (LF) one. This 
was requested so | had to do it. 


Printing is allowed, and due to 
differences in the Quill page 
length, you are allowed to edit 
headers & footers to add the 
page number (and other bits) 
so that regardless of the origi 
nal format, you get the correct 
page numbers for whichever 
printer you happen to be using 
under Windoze. Fonts can also 
be changed and saved as de- 
fault etc etc. There is even a 
help file (gosh!) Background co- 
lours {or even color for our 
American cousins!) can be se- 
lected but don't get printed - 
there is no point really. And, as 
they say, ‘and lots lots more! 

| have enclosed a screen dump 
of the program in action (at 
work) as a gif file, which | think 
Jochen can convert and in- 
clude in the magazine. Hope- 
fully, you will like what you see 
and take a trip to Dilwyn's web 
site to download it. Remember, 
this is a Windows program, not 
a QL program. 

One problem that we had was 
when someone in my user 
group - sorry, | can’t remember 
your name :o{ - had fairly major 
problems with the program. | 


pounds 


2 x Conner 60mb 2.5" hard drive ... 10 pounds 


each 


STFM / Mega ST comes with bootup roms .. 
20 pounds each 
Minerva Mk Il v1.97, 12C bus, runtime clock ... 10 


Seagate 120mb 2.5" hard drive ... 15 pounds 
-- All prices are negotiable --- 

lf interested please phone: 

Work: 01773-852003 ext 271 (08:45 - 17:00) 
Home: 01773-741164 
(fidonet 2:2503/108) 
email: derek.stewart@bgtransco.co.uk 


was puzzled, but suggested 
turning off ‘Active desktop 
mode’ if it was turned on. This 
cured all the problems. | have 
also had problems at work with 
other programs (some mine, 
some Microsofts) with Active 
Desktop and turing it off al 
ways fixed the fault. | suggest 
turning this option off if you 
have it on! 

| hope you will all forgive me for 
taking up space in a QL maga- 
zine to discuss my _ latest 
masterpiece, but if you ever 
use a PC to do your down- 
loading etc, then why not give 
this program a try - you might 
even like it! 

| have deliberately NOT revied 
my own program, just told you 
enough to whet your appetite. 
lf anyone wants to do a full 
review, then download the file 
from Dilwyn (or Tony Firshman’s 
web site) and use it. Then write 
an article and send it to 
Editor@QLToday.com where it 
will be well received. 

Once again, apologies to rea- 
ders who don't want/like/need 
to see anything at all about 
other platforms in our maga- 
zine. 


% 
eee 


ALBEE 


BBS: 01773-741335 


Un re teil a ei 
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First off this issue | think | 
should explain the cryptic end 
to the last column. | got as far 
as the honourable mentions in 
dispatched section and then 
fell foul of the ‘too many com- 
puters syndrome. | had the 
finished column on my laptop 
but then sent the one on the 
desktop machine which did not 
have the last section on it. 

Not only that but, being the 
modest person that | am :-), | 
did not read my own column in 
the printed issue so | was very 
puzzled by the various com- 
ments on the user group when 
Norman asked why he got the 
accolade. 

So here, for those of you 
gasping for the final part, and, 
of course, to give Norman his 
due, is his Honourable Men- 


Last issue the accolade goes 
to Norman Dunbar for a little 
piece of code aptly called The 
Stripper This actually runs 
under Windoze (either 95 or 
98) and can be used to extract 
all of he control codes and 
other junk from a Quill file and 
displaying it in plain old ASCII 
format. This is a very good ad- 
dition to the growing armoury 
of files available to those who 
use both the QL and other 
systems and, best of all for 
many of you, it is free. It does 
not have the facilities or flexi- 
bility that Geoff Wicks  pro- 
grams have and it will only 
convert files from Quill to ASCII 
whereas Geoff's programs will 
convert both ways and pre- 
serve such things as under- 
lining and bold/italic styling as 
well as handling Text 87 and 
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Perfection files. 

None of this is in any way 
meant to detract from the ap- 
preciation of this program. The 
program comes as a zip file 
which can be unzipped by the 
standard Windoze programs. It 
is a fairly standard executable 
without any need for an instal- 
lation program or other exter- 
nal support files. Once you 
have unzipped it all you have to 
do is to double click the “_exe’ 
file and off you go. If you are a 
QPC 2 user you can use the 
QXLWIN Explorer to take a file 
from your QXLWIN file and 
save it somewhere on the 
Windoze hard disk. Even if you 
are not using QPC 2 you can 
always use SMSQ/E (Now you 
have to be using that!) or 
Discover to copy a Quill file 
onto a PC Format disk. Once 
you have opened the file in 
‘The Stripper the program 
goes to work removing the 
codes and the text scrolls past 
a a great speed - even on my 
cranky old 233MHz laptop. The 
resulting code is presented in a 
format as good as the original 
Quill document and can be 
saved in plain text format ready 
to be imported into a Windoze 
Word processor. 

The program has a number of 
option including the choice of 
font for the text and the choice 
of background colouring. All in 
all this is a boon fo people who 
have only a QL at home and 
want to take documents to 
work all you need to do Is to 
install this little beauty on your 
work PC and the text is there 
at your fingertips (so long as 
you can write to PC disks that 
iS}. 


The program also has a nice 
ine in Saucy icons with a twist 
in its tail. 

orman said that he did this in 
his lunch break at work - may- 
be he should go on a diet and 
produce a few more little gems 
ike this. 


Normal Service Resumed 
Right then, on to the business 
in hand. A couple of new items 
were announced on the user 
group news list. The first is a 
new C compiler ported over 
from the LINUX platform by 
Richard Zidlicky. This was the 
source of frantic activity by 
some of the uSer group regu- 
lars. So far the jury is out about 
this new addition to the C com- 
pilers armoury but, in the 
ensuring debate a few people 
seem to question its speed. | 
still feel that a C compiled pro- 
gram is inherently slower than 
a machine code one but saying 
this always Seems to create a 
loud discussion. 

Programmers on other plat 
forms use C a lot but then they 
have oodles of excess proces- 
sor speed and memory to 
hand they dont really care 
about making it too tidy. | am 
no programmer so | cannot 
speak for my own experience 
but | would like to see more 
native machine code stuff avai- 
lable for us. This, of course, 
brings us to the problem of pro- 
grammers. 

These days, it would seem, we 
have a distinct lack of people 
writing QDOS/SMSQ _ pro- 
grams. There is a lot of activity 
going on porting programs and 
utilities from other platforms 
and | am in no way knocking 
that but we also need to get 
more programs written directly 
for our own platform. 

Don't get me wrong here, there 
is a lot of good work being 
done, especially by people like 
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Theirry Godefroy with his 
excellent utilities and Micro- 
Emacs and by people like 
Wolfgang Lenerz, Geoff Wick, 
Rich Mellor Simon Goodwin, 
and George Gwilt among 
others. There is. however a 
feeling around that we are mis- 
sing out and we should be able 
to have more. True, the PC has 
all of the flash and verve that 
our platform lacks but then it 
has a multimillion dollar industry 
behind it. In our case we have a 
handful of dedicated program- 
mers and talented amateurs. 


The Hardware Store 

Right now the pace of hard- 
ware developments seems to 
be overtaking the software 
one but that is probably more 
down to a lack of a proper 
framework for the colour Poin- 
ter Interface. Nasta is bubbling 
over with enthusiasm for the 
Goldfire - so much so, in fact, 
that we may have to pin him 
down to stop him running into 
too many redesigns and get 
the prototype off the ground 
and the Q40, in spite of its 
teething problems, is proving to 
be a very popular machine. 

Of course all of this is for 
nothing if the software is not 
there and that becomes increa- 
singly difficult. The things that 
most people seem to want 
involve some sort of commu- 
nication with the outside world. 
Even things as simple as printer 
drivers are making life harder 
and harder for the writers of 
QL software as the manufactu- 
rers put less and less software 
hooks into their machines and 
leave more of the functionality 
to the O/S. This would be OK if 
they allowed the information 
out freely but many of these 
manufacturers want to keep 
this all close to their chests. 

In the course of my current job | 
had to call a chip manufacturer 
to ask about an I/O chip used 
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on anew PC motherboard and 
they would not give me any 
solid information. Try buying a 
new printer to use with your 
QL and you will be amazed to 
find out that there are very few 
that will do the job. 


Ink Squirters - again! 
Even Epson have very few 
models which still have the vital 
ESC/P2 driver interface. (1 was 
recently told that the company 
that makes Epson printers 
made the first daisy wheel prin- 
ters and, when the dot matrix 
first came out decided to call 
the company Epson - Son of 
Electronic Printer - can anyone 
confirm this?) 

There are currently only two 
models of Epson Printers which 
have the vital ESC/P2 drivers. 
The Stylus Colour 900 is one of 
the better inkjets with an im- 
pressive speed and a very high 
resolution. All of the models be- 
low this are driven by the ESC/P 
raster driver which is wholly de- 
pendant on the O/S for its func- 
tion. You may be interested to 
hear that there is also an 
EPSON-laser_ printer with the 
ESC/P2 driver, the EPL N5700. 
This is not too expensive (well it 
does have a recommended re- 
tail price of +VAT but you get it 
cheaper than that) so if you 
want a good quality mono prin- 
ter for your ProWesS output 
then check this one out. Don't 
forget, though, that programs 
that do not utilise the full pos- 
sibilities of the ESC/P2 codes 
will only produce an output simi- 
lar to that of the driver you are 
using. If you are printing your 
files from Quill, say, and using 
the FX 80 driver you will only 
get an output based on the 24 
pin driver - not a good compro- 
mise for a laser printer Although 
you can change a lot of the 
attrioutes of the driver itself the 
basic underlying code will only 
give a 24 pin type resolution. 


Text 87 

Text 87 does have a very good 
driver for the EPSON ESC/P2 
drivers and, with this, you get a 
very good selection of fonts. 
There are, however, other pro- 
blems which will come to light 
more and more with Text 87. 
When Fred Toussi wrote the 
program (in 1987 - believe it or 
not) there was no such thing as 
extended resolution so the pro- 
gram was stuck in 512 x 256 
resolution. Later when the Atari 
QL emulators came out, he up- 
dated the program to allow the 
use of the new high resolution 
screens, When the Aurora was 
released a few years ago it 
brought another problem to 
light. The way in which Text 87 
calculated the screen size was 
fine for both the Atari and QXL 
emulators but fell over specta- 
cularly when the new high 
resolution Aurora screens ap- 
peared. Phil Borman popped up 
and wrote a very neat patch to 
allow Text 87 to run on the 
Aurora So all was well but, now 
that the new colour drivers are 
beginning to appear the pro- 
blem is arising again. 

There is not a problem with the 
program's operation, as such, it 
is just a display corruption but 
that is just as bad as the 
program not working at all. It 
occurs because the old ‘mode 
4’ resolution now only exists in 
high resolution/high colour 
mode. Mode 8 still exists but 
this is not really useful for this 
purpose. 

There have been a couple of 
Suggestions on how to deal 
with this problem. The most ob- 
vious way to deal with it would 
seem to be to get Fred Toussi 
to re-write the interface to use 
the new drivers but this does 
not seem to be happening so 
we will have to fall back on a 
different solution. In the ab- 
sence of someone to write a 
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patch for the program what we 
need is a special mode for Text 
87 to run in. The obvious an- 
swer Is to get rid of mode 8 
because | am reasonably sure 
that very few of the people 
who will be buying the new 
versions of SMSQ/E will either 
not be running mode 8 apoli- 
cations or willing to give up this 
option for a better four colour 
high resolution, mode 4 for the 
programs that will not use the 
newer modes. This is some- 
thing that we need to address 
as soon as possible. 


How Soon We Forget 
Another recent exchange on 
one of the internet user group 
lists was between Theirry 
Godefroy and Jonathan Hud- 
son. Theirry was expressing 
the view that UQLX was ‘full of 
bugs’ and Jonathan leapt to its 
defence. As usual, in situations 
like these, the old hobby 
horses get wheeled out for 
jousting and the efforts of 
some people to extend the 
basic QL's abilities came under 
fire. UQLX, like most of the free 
QL emulators runs as a JM or 
JS rom with the additional abili- 
ty to use the Toolkit 2 exten- 
sions if you can extract them. | 
cannot say anything about 
UQLX because | have no ex- 
perience of it but | do know 
that given the choice | would 
always use SMSQ/E over any 
other QL O/S. 

The issue arose when Theirry 
said that using the MAKE_DIR’ 
command in UQLX caused an 
error Theirry said this was a 
bug and Jonathan said that it 
was not. As always it was a ‘Six 
of one and half a dozen of the 
other’ situation. The ability to 
create subdirectories comes 
not from the Toolkit 2 routines 
but from the extended level 2 
drivers that appeared on the 
later versions of the Trump 


Card, and the ATARI emulators. 
It has existed and been part of 
our environment for so long 
that most of us have forgotten 
where it came from and when it 
arrived. The ironic thing is that 
there is a bug in UQLX which 
also relates to the same area 
and this argument between 
two QL giants pinpointed it. 
The other day | had to set up a 
machine for a QL user who 
was feally still in the Quill and 
Archive stage of life. | was 
amazed how much |! had for- 
gotten about the programs | 
had started out with. 


Honourable 
Mentions in 


Dispatches , 


Honourable Mentions 


in Dispatches 

This issue the accolade goes 
to someone whose work you 
all have yet to see. The only 
evidence that it exists at all is 
an email sent to the user group 
on the internet a few weeks 
ago. Jonathan Dent has sent 
the first email to be generated 
on a native QL with its own 
TCP/IP stack. This may not look 
that momentous | grant you but 
it will open the door to many 
QLers who want internet 
access. These are just the first 
steps but, in my opinion, very 


important ones and very 
deserving of this issue's 
accolade. 


Once the TCP/IP stacks are 
released to the public we can 
get to work on a dedicated 
Email client and possibly a web 
browser Email ability should be 
very easy and | believe that 
Jochen has suggested that QD 
could form the basis of the 


package for this but web brow- 
sing is more problematic. There 
are still many hurdles to be 
overcome before we are all 
online with our QLs and, for 
many of users it will mean 
investing in a SuperHermes and 
maybe a Super Gold Card (if 
you can get one} but this was 
‘one small text message for a 
man - one giant Quantum Leap 
for QLers. 


Apology 

Finally an apology for the 
Shortness of this column this 
issue. The problem was partly 
that | had to get it done before 
Jochen set out for the Italian 
show by car and partly due to 
the fact that my wife is now 
just over six months pregnant 
with our new daughter (yes we 
Opened our Christmas pre- 
sents early and looked at the 
pictures). In her current ‘large’ 
condition she cannot do too 
much so | am doing a lot of 
‘domestic stuff, By the time the 
next magazine comes out we 
should be a bigger family and 
my wife back to her sylph like 
figure. 


Editor’s final word 


You may wonder about the fact 
that Roy pinpointed most of the 
issues which matter to many 
QLers now - and that we alrea- 
dy mentioned many of them in 
other articles in this issue of QL 
Today. 

We must be psychics, because 
Roy did not know any of the ar- 
ticles (neither the contents, nor 
the subjects) which you find in 
this issue - or alternatively and 
more likely - we all think about 
the current problems and their 
solutions. We can't solve all of 
them immediately, but YOU may 
be able to help - e.g. by dealing 
with the printer situation. 


Sat., 25th of November - NL-EINDHOVEN|!!! 
The last show for this year (at least the last one reported to QL 
Today). Same venue as always - St. Joris College. 

If you have not been to QL 2000 (you really dared!), Italy or 
France, then this is your last chance for this year to meet up! 
So, please come along, show interest, and help to make sure 
we will have more meetings in the future! 


Latest News: EPSON Stylus Color 880 


Look what | just discovered on the | 
EPSON Website! A brandnew modell | 
With a resolution of 2880 dpi, a prin- 
ting speed of up to nearly 12 pages | 
per minute (b/w) and a price of - yes, 
you read correctly - about £130, is 
there anything else you can wish? 
Yes, of course, we would like it to sup- 
port full ESC/P2. EPSON may have 
heared our wishes - it does say on 
the website and on the fact sheet 
that it supports ESC/P2. What surpri- 
ses me a bit is, that it only supports 2 
bitmap fonts and one (scaleable) - so | 
it has to be ESC/P2, but with a limited 
range of fonts. Anyway, this is pretty | 
good news because we should be | 
able to connect it to the QL and use it 
with Quill, graphics programs etc. 
without the need to change the driver. 
However, this does still mean, that an | 
ESC/P2 Raster driver would be more | 
than useful too! 


| To all readers, show organisers, authors! 
| Please inform us as soon as possible about forthcoming QL shows | 
| next year. The earlier we can inform our readers, the better. | 
| The deadlines have moved more and more towards printing time - | 
| this puts a lot of additional on me, it really does. To help us in | 
| providing you with this magazine with the same quality and to make | 
| sure we can deliver QL Today to you in time, then please try to send | 
| material to the editors as soon as possible. 


